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Center, Houston, Texas, under contract NAS9-13864. 
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Release 7 of the HAL/S^-360 compiler system. 
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new changes since the previous version of the HAL/S-360 
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1 . 


INTRODUCTION 


1.1 Purpose of This Manual 

The purpose of this manual is to provide the information 
needed by programmers to compile and execute a HAL/S program. 
It also provides a detailed discussion of the printed matter 
that will be produced as a result of the compilation and 
execution of a HAL/5 program. This manual is not intended as a 
guide to the HAL/S language. It is a reference document to be 
used in the process of getting HAL/S programs compiled and 
debugged on the II3M/360. A knowledge of the HAL/S language 
syntax and programming techniques is presumed in some of the 
discussions. 


1.2 Scope of This Manual 

The succeeding sections of this document present a system 
guide for all phases in the development of a successful HAL 
program. Topics range from operating system communication to 
interpretation of debugging aids. A final section presents 
features of the HAL programming system that have specific 
System/360 dependencies. 
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2. RUNNING A HAL/S PROGRAM 


2.1 Communication with OS/360 - Job Control Language 

2.1.1 Introduction 

All communication between the programmer and the 
operating system of the host computer must be done through 
Job Control Language (JCL). In this section/ the basic 
j CL that must be provided to invoke HAL/S will be 
presented. A detailed discussion of JCL is not attempted. 
The intent is to give first-time and average users 
sufficient information to begin running. A more detailed 
description of the HAL/S JCL is available in Appendix C. 
That description is written for persons experienced in 
handling JCL and therefore does not "teach" the use of 
JCL. 


2.1.2 The Catalogued Procedure 

Because JCL is a complex language/ the operating 
system (OS/360) allows for the grouping and saving of 
whole blocks of JCL. Such a saved block of JCL is known 
as a catalogued procedure- When this facility is used/ 
the programmer need only submit a minimum of his own JCL 
to make a run- The descriptions that follow presume the 
existance of a catalogued procedure that will compile/ 
load/ and execute a HAL/S program- r A listing of a 
prototype catalogued procedure (HALSCLG) is presented in 
Appendix C. Any JCL modifications that are desired may be 
made in the standard manner described in the IBM 
publication • 

IBM System/360 Operating System: 

Job Control Language Reference 
Order #GC28-6704 

The user calls in the catalogued procedure by referencing 
it by name on an EXEC card as follows: 

//ANY NAME EXEC HALSCLG 

This card is sufficient to call in the catalogued JCL and 
begin execution of the st^ps. in the compilation process. 
If no other information is supplied on this EXEC card/ all 
options available to the programmer for specification will 
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default to that set of options saved in the catalogued 
procedure. The user may change or add to these options by 
specifying more information on the EXEC card. 


2.1.3 The Optional Parameters: OPTIOM and RUNPARM 

The HAL/S compiler has various options that the user 
may specify through JCL. These options invoke functions 
in both the compilation and execution steps of a HAL/S 
job- The catalogued procedure HALSCLG allows the 
specif ication of these options via the keyword parameters 
OPTION or RUNPARM. These parameters are coded on the EXEC 
card as follows: 

//ANY NAME EXEC HALSCLG , OPTION= '??' r RUNPARM* '?? ' 

The OPTION parameter is put into the FARM field of the 
compilation step and is available to the compiler for 
interpretation and action (valid options are listed in 
appendix A). The RUNPARM parameter is similarly made 
available to the HAL/S execution-time monitoring system- 


2.1.4 Specifying the Source Language Input 

The user must identify, through JCL, the location of 
the source program that he wants compiled. The typical 
input is from punched cards. The compiler reads the 

source input from the DD card named SYSIN. This card is 
not supplied in the catalogued procedure because the user 
must do the specification. For card input, the 

specification would be: 

//HAL. SYSIN DD * 


Source cards 


/* 
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where the * on the DD card indicates input to follow. 
When source images are saved on some other medium* the 
HAL.SYSIN DD card must still be included* ^nd the 
specification qn the card must correctly identify the 
source file- Refer to the IBM JCL manuals for the 
techniques needed- 


2.1.5 Specifying the Standard Execution-Time Input 

The catalogued procedure makes the assumption that 
the primary data input to the running HAL/S program will 
be made via sequential input file #5. This means that the 
catalogued procedure supplies a DD card with the name 
CHANNEL 5 . The use of the HAL/S statement: 

READ ( 5 ) <specif icatfon list>; 

causes data to be read from the dat^ set defined by the 
CHANNELS DD card. The catalogued procedure is organized 
to associate the following JCI* cards with CHANNELS® 

//GO.SYSIN DD * 


Data cards 


/* 


This DD card may alternately be defined in any suitable 
manner to reflect the location of the desired input data. 


2.1.6 Specifying the Standard Execution Time Output 

The catalogued procedure provides the necessary JCL 
to direct the results of the following HAL/S statement to 
a line printer: 

WRITE(6) <specif ication list>? 

The JCL statement responsible is the 

//CHANNEL6 DD 


statement • 
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2.1.7 Specifying Additional Execution-Time JCL 

The HAL/S programmer may reference 10 separate 
sequential files with HAL/S I/O statements. In HAL/S 
statements of the form: 

READ 

WRITE (n) <specif ication listing> 

READALL 

where n may vary from 0 through 9. These statements cause 
the requested I/O operation to occur on data defined by 
JCL cards of the following form: 

//CHANNELn DD appropriate specif ication> 

where n is the same as in the HAL/S I/O statement. Cards 
of this form may be added to the JCL brought in from the 
catalogued procedure by following the rules described in 
the IBM JCL publications. 


2.1.8 A Typical Run Submission 

The following JCL is an example of a typical user 
run. The user has his HAL/S program and his 

execution-time data on punched cards. In addition, his 
program contains a WRITE(7) ... statement that he wishes 
to direct to a card punch. 

1 //ANYNAMEl JOB installation dependent parameters> 

2 //TRYHAL EXEC HALSCLG , OPTION*' LISTING2 ' 

3 //HAL.SYSIN DD * 


4 Source Program 


5 /* 

6 //GO. CHANNEL 7 DD SYSOUT=B 

7 //GO.SYSIN DD * 


3 Data Cards 


9 /* 
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Comments on individual lines in the example: 

Is The user must supply a JOB card to identify himself to 
the operating system and to give pertinent 
accounting information- The form of this card is 
installation dependent- Questions regarding its 
form should be directed to the installation 

operations staff. 

2: This, the EXEC card, causes the JCL saved in 

catalogued procedure HALSCLG to be read by the 
operating system. The label TRYHAL is optional and 
if included may be any 1 to 8 character name 
beginning with a letter. If omitted, at least one 
blank must separate the // and the word EXEC. 
Following the name of the catalogued procedure, the 
user has coded some optional parameters as 
specified in Section 2.1*3 of this document. The 
OPTION keyword shown causes the string 'LISTING2' 
to be available to the compiler. The compiler 
recognizes this as a directive to produce an 
auxiliary source listing (See Sec. 3.8). 

3: This card identifies the primary compiler input as 

cards immediately following- 

4: The source cards follow. 

5: The /* delineates the end of the in-line source cards 

and indicates a return to JCL card processing. 

6: The CHANNEL7 DD card defines the destination of the 

HAL/S program's references to device #7 as system 
output class B (SYSOUT=B). At a typical 360 
installation, this class refers to the card punch. 

7: GO.SYSIN defines the input data set associated with 

HAL/S references to device #5. 

Note: Because of the way the HALSCLG catalogued 

procedure is written, this could also have 
been specified as: 

//GO . CHANNEL 5 DD * 

3: The data cards to be read from channel 5 corne next. 
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9: The /* terminates the input card data and indicates a 

return to JCL processing. No special end-of-job 
J CL indication is needed. The operating system 
will determine the job boundaries by the occurrence 
of subsequent JOB cards. 




2-6 


INTERMETRICS INCORPORATED • 701 CONCORD AVENUE • CAMBRIDGE, MASSACHUSETTS 02138 * (617) 661-1840 



2.2 Compiler Outputs 


2.2.1 Source Listing 

As a result of the compilation process/ a listing of 
the user-supplied source code is printed by the compiler. 
This primary listing has been formatted by the compiler to 
conform with standard output rules- The primary listing 
is always produced and is written to the data set defined 
by the SYSPRINT card- 

The HAL/S compiler operates as three separate phases: 
Phase I is the syntax analysis phase ? Phase II is the 
code generation phase; and Phase III is the diagnostic 
table generation phase- Each phase produces some 
informational and diagnostic output which together make up 
the primary source listing- 

An optional unformatted listing is available. The 
user must specify the LISTING2 option in the OPTION field 
of the EXEC card which invokes the HAL/S catalogued 
procedure . 

The formats of both of these listings are discussed 
in Section 3- 


2.2.2 Tables 

In addition to reproducing the HAL/S language source 
code, the compiler also prints various tables that contain 
information of interest to the programmer- The tables 
include the Symbol Table & Cross Reference Table, giving 
name, type and usage information of identifiers, and the 
Macro Table giving a summary of replaced names. See 
Sections 3.6 and 3.7 for descriptions of these tables. 


2-2-3 Summaries 


The HAL/S compiler produces summaries 
actions taken within a particular program 
close of that block and a quick-ref erence 
description at the end of the compiled 
Sections 3-3 and 3-4. 


of programmer 
block at the 
program layout 
program- See 


1 ? *y < 

-cb— 15 
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2.2.4 Diagnostics 


The compiler produces error messages when syntax 
errors or other abnormal conditions occur. These error 
messages are interlisted with the source listing. An 
error summary is provided at the end of the Phase I 
listing. Section 4 discusses compile time diagnostics in 
detail. 

2.3 Subsequent Steps 


2.3.1 Link Step 

After an object file has been produced as described 
above, it must be further processed into a form suitable 
for loading and execution- This process includes the 
resolution of any references to HAL/S library routines and 
the generation of appropriately- sized work areas required 
by the HAL/S programs at run time. These tasks are 
accomplished in the second step of HALSCLG . This step 
invokes a program known as HALLINK, a HAL/S compiler 
system program which performs all necessary functions. 
The HAL LINK program dynamically invokes the System/360 
Linkage Editor as part of its operation. 

The printed matter generated by this step in the 
HALSCLG procedure appears in three parts: 

1) A standard output produced by the Linkage Editor 
which may consist of a module map and size 
statistics. Descriptions of this listing may be 
found in the appropriate IBM system manual: 

IBM System/360 Operating System 
Linkage Editor apd Loader 
Form GC28-6538 


2) A HALLINK listing which documents the tree structure 
of all HAL/S modules involved in the link edit. 

3) A second standard linkage editor listing as described 
above. This listing will incorporate changes made to 
the module structure by the HALLINK program. This 
second link editor listing is the one corresponding 
to the final load module produced by this step- 

The HALLINK step puts its final result on a direct access 
device suitable for subsequent loading and execution. The 
load module thus produced requires a third step to be 
executed. A more thorough description of the HALLINK 
program may be found in Appendix I- 
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2.3.2 The Execution Step 

The execution of a compiled HAL/S program may produce 
both user- defined output and system diagnostic output- 
The user output occurs as a result of HAL/S I/O 
statements. The system diagnostic output can occur as a 
result of execution errors detected by the system or as a 
result of user requests for dynamic dumps and traces. 


2.4 Creating and Running Program Complexes 


2-4.1 Introduction 

Section 2-1 has explained hov; to run a self-contained 
HAL/S program- However, the form of the language allows a 
HAL/S program to use data external to itself (COMPOOLS), 
and to call external procedures or functions (COMSUBS). A 
HAL/S program and the compools and comsubs it uses are 
collectively known as a PROGRAM COMPLEX- This section 
explains how to create and run a program complex- 


2-4-2 The Form of Compools and Comsubs 

This subsection briefly recapitulates the forms taken 
by compools and comsubs in the HAL/S language. Both 
compools and comsubs are treated by the HAL/S compiler as 
independently compilable entities in the same way as a 
program. 

The form of a cdmpool is illustrated by the following 
example: 


DATA: COlMPOOL; 

DECLARE S SCALAR INITIAL (2 . 5 ) ? 
DECLARE I INTEGER INITIAL (5); 
CLOSE DATA; 


Fig. 2-1 
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by the 


The form of a typical comsub is illustrated 
following example: 


ROUTINE: PROCEDURE ( X ) ; 

DECLARE X SCALAR; 
WRITE ( 6 ) X? 

CLOSE ROUTINE? 


Fig* 2.2 


A program using data in the compool DATA and calling the 
comsub ROUTINE must contain the appropriate matching 
templates for them. Such a program is illustrated by the 
following example: 


DATA: EXTERNAL COMPOOL; 

DECLARE S SCALAR INITIAL ( 2 - 5 ) ; compool 

DECLARE I INTEGER INITIALS); template 

CLOSE DATA; 


ROUTINE : EXTERNAL PROCEDURE { X ) ? comsub 

DECLARE X SCALAR? template 

CLOSE ROUTINE? 


TEST: PROGRAM; program 

CALL ROUTINE ( I/S ) ? proper 

CLOSE TEST? 


Fig. 2.3 


The HAL/S language of course also allows comsubs themselves to 
access compool data and/or other comsubs. Templates, like 
those shown in the example above, are produced automatically by 
the HAL/S-360 compiler when a compilation unit requiring a 
template is compiled. The template produced is written as a 
member of a partitioned dataset which may then be INCLUDE'd at 
the appropriate place in another compilation which is to make 
use of the template. See Section 6.2 for the technical details 
of the HAL/S-360 implementation of templates* 


2-10 


INTERMETRICS INCORPORATED • 701 CONCORD AVENUE • CAMBRIDGE, MASSACHUSETTS 02138 • (617) 661-1840 



2.4.3 Compiling a Program Complex 

To compile a program complex/ the program module and the 
compool and comsub modules must each be compiled separately. 
Each module is compiled in exactly the same way. However/ due 
to a requirement dictating that a template (as described in 
Section 2.4.2) be included in a compilation referencing a 
previous compilation r the compools and comsubs themselves should 
be compiled in an order such that their templates are available 
when needed. 

For each compilation/ a catalogued procedure should be 
used which incorporates JCL enabling the object module (or 
optionally a load module form of the object module) to be saved 
until all modules are compiled; e-g- the HALSC or HALSCL 
catalogued procedures in Appendix C. 

When compiling the individual pieces of a program complex/ 
any templates produced should be directed via JCL to a common 
template library which can then be used as an INCLUDE library 
for referencing the templates. 

When all compilations have been completed/ the individual 
modules are linked together with the runtime library by using 
the HALLINK program (e-g- via the HALSL catalogued procedure 
listed in Appendix C). The resulting finished load module may 
then be executed as previously described for a simple program. 

Each compilation also produces symbolic data used as a 
run-time debugging aid. In compiling and executing simple 
programs using the catalogued procedure HALSCLG/ this symbolic 
data is written on a member of a temporary PDS passed to the 
load step of the JCL. Here are two methods for insuring that 
the symbolic data for all modules of a program complex are 
correctly made available at execution time: 
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(i) The symbolic data for each module is saved on a different 

member of a PDS common to all compilations- In the 
execution step this dataset should be specified on 
the HALSYMB DD card- (See catalogued procedure in 
Appendix C - ) 

(ii) The symbolic data for each module is saved on a different 

PDS (each of which will therefore only have one 
member). In the execution step, the HALSYMB DD cards 
should specify the catenation of all the PDS's used- 


2-4-4 An Example of Program Complex Compilation 

To illustrate the procedure for the creation of an 
executable program complex, the following example is provided. 
Let there be four separately compilable units, as follows: 


Unit 1 - A COMPOOL named DATA defined as: 

DATA: COMPOOL? 

DECLARE I INTEGER? 

DECLARE S SCALAR? 

CLOSE DATA? 


Unit 2 - A PROCEDURE named PR0C1 defined as: 

D INCLUDE @ DATA 

PR0C1 : PROCEDURE (X) ; 

DECLARE X SCALAR; 

WRITE (6) 'THE ANSWER IS:' (X+S); 
RETURN? 

CLOSE PROCl ; 


Unit 3 - A PROGRAM named PR0G1 defined as: 

D INCLUDE @ DAT-A 
D INCLUDE @ PROCl 

PR0G1: PROGRAM; 

CALL PROCl (S) ; 

CLOSE PR0G1 ; 


Unit 4 - A PROGRAM named DRIVER defined a s: 

D INCLUDE @ DATA 
D INCLUDE @ PROCl 
D INCLUDE @ PROG 1 

DRIVER: PROGRAM; - _ 
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CALI* PROCl(S); 
SCHEDULE PROG1; 
CLOSE DRIVER; 


Note the relationships between the various pieces of this 
program complex* Units 2, 3, and 4 all reference data in Unit 
1. Units 3 and 4 reference Unit 2. Unit 4 also references Unit 
3. The HAL/S-360 Compiler must be given information about these 
separately compiled units whenever references to such units 
occur* The necessary information is generated automatically 
when each unit is compiled- It is, therefore, necessary to 
compile the units in an order which makes the information in a 
given unit available when needed by subsequent compilations* An 
example of a single job to perform these compilations and 
execute the resultant module is presented next* Comments on the 
example follow. 


//TRYIT JOB PARAMETERS > 

/ / STEP 1 EXEC HALSC 
//HAL.SYSIN DD * 

CUNIT #1 SOURCE> 

/* 

//STEP2 EXEC HALSC 
//HAL.SYSIN DD * 

CUNIT #2 SOURCE> 

/* 

//STEP 3 EXEC HALSC 
//HAL.SYSIN DD * 

CUNIT #3 SOURCE> 

/* 

// STEP 4 EXEC HALSCLD , RUNPARM= ' FI RSTPGM— DRIVER' 
//HAL.SYSIN DD * 

CUNIT #4 SOURCE> 

/* 


STEPl above compiles the COMPOOL named DATA* Because of 
the way the HALSC catologued procedure is defined, the object 
file for the compilation is placed on a temporary file which is 
passed on to the later steps. This compilation also produces a 
template for the COMPOOL as described in Sections 2*4*2 and 
6*2.9. The template is also saved in a temporary data set and 
passed to 'later steps, in a similar way, a simulation data file 
(SDF) for the COMPOOL is produced and passed on* 

Step 2 compiles the PROCEDURE named PR0C1. Note that the 
source code for the compilation contains the following include 
compiler directive: 

D INCLUDE ®DATA 
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This directive is a request for the compiler to locate and read 
the template ("@" indicates a template name) for the COMPOOL 
named DATA. The template must be available for the succesful 
compilation of statements referencing items in that compool. 
The compiler finds and uses the template that was automatically 
generated in STEP1. (see Section 6.2.9 for more details on 
template look-up. ) Step 2 adds the object file for the 
PROCEDURE named PR0C1 to the object file passed from step 1. It 
also produces a template for PR0C1 and an SDF and adds them to 
the existing files- These files are then passed to later 
steps. 


Step 3 performs in a manner similar to step 2, this time 
compiling the PROGRAM named PR0G1- This compilation requires 
access to both of the previously compiled units. The source of 
the compilation therefore contains INCLUDE directives to cause 
the compiler to retrieve the necessary information. Again, 
object, template, and SDF files are produced and passed along. 

Step 4 invokes the HALSCLG catalogued procedure because 
this step will perform the last of the compilations, and then 
execute the entire complex. The source code for the PROGRAM 
named DRIVER contains the INCLUDE directives needed to retrieve 
the templates for the previous compilations that are to be 
referenced by DRIVER. The HALSCLG catalogued procedure adds the 
object deck for DRIVER to the others, produces an SDF, and also 
produces a template for DRIVER. Production of the template in 
this case is unimportant because no subsequent steps will need 
the template. HALSCLG then proceeds to link the object decks 
for all four compilations together with the necessary library 
routines to form a module suitable for execution. The last 
function of HALSCLG is to initiate execution of the module. 

Note that there is some ambiguity inherent in this module as to 
which of the two PROGRAM'S in the module is to begin execution. 

If no statement to the contrary is made, execution defaults to 
the first PROGRAM unit in the module which in this case would 
be PROGl. The intention, however, is to begin execution with 
DRIVER which will in turn invoke PROGl. It was the hierarchical 
reference requirements which caused the compilation of the 
units in the order illustrated. The way in which the correct 
PROGRAM may be specified in a multiple-PROGRAM complex is shown 
in step 4 JCL. The EXEC card for step 4 contains the aprameter: 

RQNPARM=' FI RSTPGM=DRI VER ' 

This specification causes the quoted string to be available to 
the execution step of the HALSCLG catalogued procedure. The 
FIRSTPGM option (see Appendix B) specifies the full name of the 
PROGRAM which is to begin execution in the load module. 

During execution of the program complex, the SDF files 
created and passed by the previous steps are available to the 
runtime package of the executing module. If any errors occur, 
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or if any user requests for debugging diagnostics were entered/ 
these SDF files would permit accurate dumps and traces of HAL 
data items to be produced. 

The complex would be executed as directed and after 
execution/ all temporary data sets used to collect the object 
files/ templates/ and SDF's would be deleted by the operating 
sy stem. 

This example shows only one method for building an 
executable module. It is/ perhaps/ the simplest because it 
presumes that all information passing is done via temporary 
datasets built automatically by the catalogued procedures. 
Users wishing to save the results of individual compilations 
may define permanent template/ SDF/ and load module libraries 
to be used in place of the temporary ones. The operations which 
must be performed to eventually create an executable module 
remain the same* 


£ 5 < 

2-15 


INTERMETRICS INCORPORATED - 701 CONCORD AVENUE • CAMBRIDGE, MASSACHUSETTS 02138 • (617) 661-1840 



3 


COMPILATION LISTINGS 


3.1 General Description 

The listings produced by the HAL/S compiler are designed 
to document the actions taken by the compiler in the generation 
of an executable form of the user's source program. The user's 
code is reproduced in an annotated form and* optionally, in its 
original form. All tables and error messages generated by the 
compiler are also considered part of the documentation. They 
are described in the following sections. 


3.2 Formats 

The numbered notes in the following discussion refer to an 
example of a HAL/S source listing shown in Figure 3.1. 


3.2.1 Listing of Options in Effect 

On the first page of a compilation listing, the 
HAL/S-360 compiler prints a summary of all compile-time 
options in effect for the compilation (27). See Appendix 
A for a list of available options. 


3.2.2 Headings 

A one-line page header (1) begins every page of the 
listing. It contains compiler version identification and 
page number within the listing. 

On page one of the listing, the date and time of 
generation of the compiler are printed, followed by the 
date and time at which the current compilation was begun 
( 2 ). 


Following any header information on each page of the 
listing, a field description line is printed (3). This 
line breaks the page into columns, the contents of which 
are described below. 


3.2.3 Statement Number 

The statement number field (4) headed by the title 
"STMT" contains the compiler-assigned sequence number for 


3-1 




INTERMETRICS INCORPORATED • 701 CONCORD AVENUE * CAMBRIDGE. MASSACHUSETTS 02138 * (617) 661-1840 



each HAL/S statement. This field is filled in for each 
M-line in the source listing. The "STMT" field for E-line 
and S-line entries as well as for comment cards and 
compiler directives is left blank. 

IJote that the statement number is associated v/ith a 
complete HAL/S statement/ not with the physical number of 
M-lines. Thus/ if a HAL/S statement spans several 
M-lines/ the same statement number will appear on each 
M-line. 


3.2.4 Line Type 

The STMT field is followed by a blank and then by a 
single character field (5) used to indicate the type of 
source line* HAL/S has multi-line subscripting and 
exponentiation capabilities. Such multiple line use is 
identified for easier reading. 

The compiler places an indicator of line type in this 
one character field. The possible values of this field 
are • 


C = Comment line; 

D = Compiler directive line; 
E = Exponent line; 

S = Subscript line; 

M = Main line. 


These values correspond generally . to the card types 
(punched in column 1) of the user's source cards. 


3.2.5 Source Field 

The next field on the page (6) is centered under the 
title ’’SOURCE". This field contains the actual HAL/S 
language text. Vertical bars at either side delimit the 
field. The field itself is 100 characters wide and is 
filled by reformatted source text, complete with 
compiler- supplied annotation- 


3.2.6 Current Scope Field 

Following the source delimiter ( \ ) at the right of the 
SOURCE field/ is the variable length field headed by 
"CURRENT SCOPE" (7). This is an information field which 
contains the name of the HAL/S program block to which the 
current source line belongs. This field applies only to 
C, D, and M lines. 
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3.2.7 Information Field 


To the right of the "CURRENT SCOPE" field is another 
variable length area that is used by the compiler to 
supply additional information. This information may be 
any compiler generated comments regarding the current 
line. This field is applicable only to M-lines. 


3.3 The Output Writer 


3.3.1 Concept 

The HAL/S compiler has been designed to provide 
standard / automatic annotation of its output listing to 
enhance the readability of HAL/S source code. The HAL/S 
system allows each programmer to enter programs in a 
free-form input consistent with individual coding 
preferences. The compiler then edits the input during 
compilation into the standard form so that all program 
listings will observe the same coding rules. 

HAL/S is a block-oriented language, and the logical 
indenting of program blocks can do a great deal to enhance 
understanding of program structure. The* programmer can do 
this indenting himself. But the problems involved in 
inserting new indentation levels into existing code often 
result in considerable wasted time because it is necessary 
to re-punch! existing lines to maintain consistency. HAL/S 
frees the programmer from this task by completely 
regenerating the indentation scheme each time the program 
is compiled. Thus, the indentation is always complete and 
reflects the total program structure. 

Although RAL/S source input is in the form of card 
images, the compiler treats the input as a continuous 
stream of information, with only the statement-delimiting 
semicolons to indicate statement boundaries. Each 
statement is stored internally until its semicolon is 
found. Then, with a complete statement in hand, the HAL/S 
output writer completely reformats the source- The 
reformatting includes referencing the symbol table to 
obtain the types of any variables in the statement so that 
the characteristic HAL/S overpunch mark may be supplied by 
the compiler. The reformatting also includes expansion of 
single line input to the full HAL/S multi-line form. 
Finally, the resulting multi-line, annotated statement is 
indented to the proper level determined by the line's 
relative position in the program. The statement is then 
placed on the output listing, using as many E-M-S groups 
as necessary to contain it. 




Rc 
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- The specific conventions imposed on the output 
listing are detailed in the following sections- 


3.3.2 Auto-Indentation 

References in this section are made to Figure 3.1. 


3. 3-2-1 Declaration Statements. The output writer 
prints out declaration statements in a way which 
makes the intent of the declaration as clear as 
possible- The word DECLARE is aligned at the 
current indent-level. If the DECLARE has factored 
attributes, the attributes are placed on the same 
line as the DECLARE and a new line begun (8). If 
no factors are present, variable names follow the 
DECLARE (9). Lists of variables without individual 
attributes are placed on the same line (10). The 
occurrence of a variable with attributes causes 
that variable to appear on a line by itself with 
its attributes (11). Any lines created after the 
DECLARE line are indented one indent level- 

Structure declarations (12) are reformatted 
into the commonly used form. Each level of the 
structure template is placed on a seperate line 
with indenting appropriate to the level number- 


3. 3-2-2 Labels. All statement labels (13) are 
right justified against the statement to which they 
apply- The statement itself is placed at the 
proper indent level before the label is applied. 
If the label will not fit on the same line as the 
statement body because of the indent location, it 
is placed on • a separate M-line predeeding the 
statement body (14). 


3. 3. 2- 3 Scope Changes. Whenever a PROGRAM, 
PROCEDURE, TASK, FUNCTION, or UPDATE block is 
encountered, the statement is placed in the output 
listing at the current level and then the indent 
level is increased one increment (15). All 
statements within the block follow the normal 
indenting rules relative to the block level 
indentation. Thus, all statements within a block 
are indented farther than the block definition. 

When the corresponding CLOSE statement is found, 
the CLOSE statement is output at the same level as 
the block definition statement and the indent level 
is reset to its value before the block was entered 
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( 16 ). 


3. 3. 2. 4 IF Statements. The IF ... THEN part of 
the statement is placed on the listing at the 
current indent level and the indent level is 
increased one increment* The "true part” of the 
statement is placed on the next level at the new 
indent level and the level is decremented one level 
(17). 

If an ELSE clause is present, the "ELSE" gets a new 
line at the current level, which is the same level 
as the "IF", and the indent level is incremented. 
The "false part" of the statement is placed on the 
next line at the new level and then the level is 
decremented one level (18). 


3. 3.2.5 DO Groups. All types of DO groups receive 
the same treatment. The statement containing the 
DO is placed in the listing at the current indent 
level and the level is incremented (19). All 
statements in the range of the DO are indented 
relative to this new level. The END closing the 
group is placed at the same level as the DO (20). 

The DO CASE statement obeys the same indent rules 
as other DO statements, but some additional 
notation is supplied by the output writer. The 
first M-line of each case is annotated in the 
information field beyond the current scope notation 
with a message of the form "CASE n" where n is the 
current case number (21). If the current case is 
really a "case within a case", (i.e., a nested DO 
CASE is in effect), the notation is "CASE a.b 
... n" where the a.b ... indicates the 
structure of the case statements in the sense of: 
case n within case b within case a ... Also, the 
END associated with the DO CASE statement receives 
the additional information "DO CASE END" to help 
associate it with its group head (22). 


3. 3. 2. 6 Continuations. A reformatted E-M-S group 
may not fit on the printed page in a single group 
after the indentation rules have been applied. If 
this is the case, the output writer breaks the 
statement into as many E-M-S groups as necessary 
(23). The break never splits an identifier or 
keyword* A literal character string may be broken* 


3. 3. 2. 7 Page Boundaries. The output writer never 
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places pieces of an E-M-S group on separate pages; 
ioG. an E-line at the bottom of one page and the 
corresponding M-line on the next. A page eject 
will always be performed before such a group is 
written. 


3. 3. 2. 8 The first line of any PROCEDURE, FUNCTION, 
PROGRAM, TASK, or UPDATE block always begins on a 
new page. 


3.3.3 Multi-line Expansion and Annotation 
References are made to Figure 3.1. 


3. 3. 3.1 Overpunches. If, after all pertinent 
subscripting has been applied, a variable name is 
of a type for which HAL/S has defined an overpunch 
character, the output writer supplies that 
character on an E-line above the variable name. 
The overpunch character is centered over the name. 

The characters available are 

"+" for matrix, vector, bit, character, and 
structure data types respectively. The mark 
supplied is determined from the totally subscripted 
form of the variable. Thus the overpunch may be 
changed by subscripting. For example, an element 
of a matrix is a scalar. Therefore, a matrix name 
subscripted down to a particular element receives 
no overpunch (24). Similarly, a matrix variable 
subscripted to a particular row of the matrix 
receives a vector mark (25). 


3. 3. 3. 2 Array and Structure Notation. Variables 
which are structure terminals or which are arrayed 
may have additional annotation supplied. If a 
particular use of such a variable has multiple 
copies due to structure and/or array properties and 
if those multiple copies have not been subscripted 
away in the particular use of the variable, the 
variable is enclosed in the appropriate marks. 
Multiple copies due to arrayness receive brackets 
and "j") while multiple copies due to 
structure copies receive enclosing braces ("/" and 

*’ i ,f ) . (26) \ 

As with variable typing (see Sec . 3 . 3 . 3 . 1 ) , it is 
possible to subscript away the "arrayness" or 
"structureness" of a variable and thus have no 
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special annotation appear. 


Note that the array and structure notation 
characters are available only on certain print 
trains such as the IB M TN chain- If a particular 
installation does not have such a print chain, the 
notation will probably appear as blanks 
(unprintable characters). 


3- 3-3. 3 Subscripts and Exponents. HAL/S allows the 
user to supply source statements in single or 
multi-line format. The output writer expands all 
source to full multi-line format before printing* 

During the expansion process, any unnecessary 
subscript or exponent grouping parentheses are 
removed. These grouping parentheses are often 
needed in single line input to show the extent of a 
subscript or exponent field. 

Subscripts applied to variables on an exponent 
line, and exponents applied to variables on a 
subscript line, are left in single line format 
since multiple line expansion would produce an 
ambiguous listing. Also, overpunch characters are 
not supplied for variables on exponent or subscript 
lines. 

The multiple lines are indicated by "E" and "S" in 
the line type field of the listing (see 3.2.3). As 
many E or S lines as needed to contain the expanded 
source are generated. 


3. 3. 3. 4 REPLACE'd 
defined as replaced 
underlined by the 
listing (27). 


Symbols. Any symbols which are 
names in REPLACE statements are 
output writer in the source 


3.3.4 Comments 


3. 3. 4.1 Comment Cards and Directive Cards. All 
comment cards (C in column one) and directive cards 
(D in column 1) are transferred unchanged to the 
output listing. Both types of card are treated 
alike, being separated by a blank line from other 
lines, and single spaced within the group. 


3. 3. 4. 2 In-Line Comments. Comments appearing on 
the M-lines of input source cards in the form of 
/* ... Comment ... */ 
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are collected by the output writer and placed into 
the output listing after the statement has been 
processed . 

The collected comments are placed on the M-line of 
the statement if possible. If there is not room# 
spill-over can occur onto as many S-lines as are 
necessary. Multiple comments on a single source 
statement are collected together and printed as one 
comment. If the size of the total comment text for 
any one HAL/S statement reaches 256# additional 
comment text is ignored and a warning issued. 
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NGDUKP INSTEAD OP DDK? 

LISTING2 INSTEAD OP NOLISTING2 

LIST INSTEAD OP NOLIST 

TPAC2 INSTEAD 0? NOTH ACE 

NODECK INSTEAD OP DECK 

jP * TABLES INSTEAD 0? NOTABLES 

jC" N0TA3LST INSTEAD 0? TABLST 

NOADDRS INSTEAD OF ADDRS 

A NOSRN INSTEAD OP SRN 

NOSDL INSTEAD OP SDL 


TYPE 2 OPTIONS 


PAGES = 250 

LINE COUNT = 59 


Figure 3-1 The HAL/S SOURCE LISTING 
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3.4 Block Summaries 


3.4.1 Concept 

The HAL/S compiler provides a summary of action taken 
within a program block at the close of the particular 
block. The blocks for which summaries are given are 
PROGRAM/ TASK/ FUNCTION and UPDATE. When the matching 
CLOSE to such a block is found/ the summary is issued and 
the listing of the program resumes with a skip to the new 
page . 


3.4.2 Information Provided 

Information contained in block summaries consists of 
lists of labels or variable names used in various contexts 
within the block. The title "BLOCK SUMMARY" begins the 
list. For all potentially summarized contexts within the 
block/ a descriptive heading is printed followed by the 
list of names involved. The headings and their meanings 
are listed below. 


a) PROGRAMS AND TASKS SCHEDULED - A list of PROGRAM 
and/or TASK names scheduled in the current block via 
the HAL/S SCHEDULE statement. 

b) PROGRAMS AND TASKS TERMINATED - A list of PROGRAM 
and/or TASK names terminated in the current block via 
the HAL/S TERMINATE statement. 

c) PROGRAMS AND TASKS CANCELLED - A list of PROGRAM 
and/or TASK names cancelled in the current block via 
the HAL/S CANCEL statement. 

d) EVENTS SIGNALLED, SET, OR RESET - A list of 

event variables declared outside the current scope 
and appearing in the current block in a SIGNAL/ SET, 
or RESET statement. 

e) EVENT VARIABLES USED - A list of event variables 
declared outside the current scope that appeared in 
one or more EVENT expressions. 

f) PROGRAM OR TASK EVENTS USED - A list of PROGRAM 
and/or TA$K names appearing in one or more EVENT 
expression s . 

g) PRIORITIES UPDATED - A list of PROGRAM and/or TASK 
names whose priorities have been updated in the 
current block via the UPDATE PRIORITY statement. 
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h) EXTERNAL PROCEDURES CALLED - A list of procedures 
called within the current block which were defined 
via EXTERNAL PROCEDURE templates* 

i) EXTERNAL FUNCTIONS INVOKED - A list of functions 
invoked within the current block which were defined 
via EXTERNAL FUNCTION templates* 

j) OUTER PROCEDURES CALLED - A list of PROCEDURE 

names which are called from within the current block, 
but are defined outside the current block* 

k) OUTER FUNCTIONS INVOKED - A list of FUNCTION 

names which are invoked from within the current block 
but which are defined outside the current block. 

l) ERRORS SENT - A list of the HAL/S error 

numbers which are sent explicitly by a SEND ERROR 
statement somewhere in the current block. 


m) COMPOOL VARIABLES USED - A list of identifiers which 
are defined in one or more COMPOOL blocks, and 
referenced or assigned within the current block (a * 
beside the name indicates "assigned into"). 


n) COMPOOL REPLACE DEFINITIONS USED - A list 

of REPLACE variable names which are defined in a 
COMPOOL block and used within the current block. 

O) COMPOOL STRUCTURE TEMPLATES USED - A list of 

STRUCTURE template names which are defined in a 
COMPOOL block and used within the current block. 

p) OUTER VARIABLES USED - A list of identifiers 

which are defined outside the current block, but are 
referenced or assigned within the current block (a * 
beside the name indicates "assigned into"). 

q) OUTER REPLACE DEFINITIONS USED - A list of 

REPLACE names which are used within the current 
block, but which are defined outside of the current 
block. 

r) OUTER STRUCTURE TEMPLATES USED - A list of STRUCTURE 
which are used within the current block, but which 
are defined outside of the current block. 


Note that in all categories except c and 1, only variables 
which have a NEST level less than that of the current 
block are included, as the block summary is an indication 
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of the impact of this block outside of i 
variables or sub blocks. A block which 
self-contained, no matter how complex, will 
block summary issued. 

The order of names in any list withi 
summary indicates the order of occurrence of 
of these names in the block within the identi 

The block summary for any block will 
the information in the block summary for any 
within it (i.e. if Procedure A contains Proc 
schedules Program C, Procedure B s block 
indicate that Program C was called, but Proce 
not ) . 


ts own local 
is completely 
not have a 


n the block 
first usages 
fied context. 

not duplicate 
block nested 
edure B which 
summary will 
dure A's will 


3,5 Program Layout Summary 

Immediately preceeding the Symbol Table printout at the 
CLOSE of the HAL/S program, there is a program layout map, 
indicating the way in which PROGRAMS, TASKS, PROCEDURES, 
FUNCTIONS, and UPDATE blocks were defined. The indent level in 
this printout indicates the nesting level definition of the 
block shown. This serves to give a quick overview of the 
program structure. Such a listing can be of assistance not 
only as a documentation aid, but also as a guide to locating 
the definition of procedures and functions which have been 
diagnosed as undefined by the compiler. 


3.6 Symbol & Cross Reference Table Listing 

The symbol and cross reference table printed at the end of 
a HAL/S compilation listing provides a detailed accounting of 
all programmer-defined symbols. The table listing is organized 
into two parts: a structure template listing and an 
alphabetized total listing. 

Any structure templates defined in the compilation appear 
first in the symbol and cross reference table. The template 
names appear in alphabetical order. The body of each template 
(i.e. the levels defined under the template name) is listed 
under the template name in the order of definition. This 
ordering provides a quick reference to the organization of the 
structure template. Special action is taken in the "NAME 1 ’ and 
"TYPE" fields (described below) to highlight the template 
organization . 

Following any listing of the templates, an alphabetized 
listing of all programmer-def ined symbols is printed. Symbols 
previously listed as elements of a structure template are 
included in this list. However, the list is completely 
alphabetized and template organization is not shown. When a 
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particular symbol is independently defined in more than one 
lame scope, the symbol is multiply listed in order of 
definition. Figure 3 .2 illustrates the form of a HAL/S 
pompiler symbol and cross reference table. 

3.6.1 "DCL” Field 

The "DCL" field is used to list the compiler-assigned 
statement number at which the identifier was first 
declared. For explicit declarations, this number will 
point to a DECLARE statement somewhere in the program. 
For implicit declarat ions , this number is the statement at 
which the identifier was first used in the program. 


3.6.2 "NAME" Field 

The "HAUL" field lists the symbolic name of the 
programmer-defined symbol. The width of this field is 
determined by the length of the longest symbol in the 
compilation. An asterisk preceeding the name indicates 
that the varaible was implicitly defined. 

Within the first part of the symbol table listing 
which contains structure template names and their 
organizations as described in Section 3,6, all parts of 
the template body have their names indented one space from 
the structure template name under which they are defined. 


3.6.3 "TYPE" Field 

The "TYPE" field describes the type of each 
programmer-defined identifer. This field will contain 
one of the following descriptions: 

INTEGER 
SCALAR 
n - VECTOR 
n X r.i MATRIX 
6IT( n ) 

CHARACTER ( n ) 

EVENT 

PROGRAM 

PROCEDURE 

TASK 

COMPOOL 

STATEMENT LABEL 
UPDATE LABEL 
STRUCTURE 
STRUCTURE(n) 

MINOR MODE 
STRUCTURE TEMPLATE 
REPLACE MACRO 
MACRO ARG. 

41 < 
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The values of n and m indicate size or dimensionality in 
their particular contexts* 

Additional information may appear in the type field* 
If the identifer has an array specification, the word 
"ARRAY” will follow the basic type specification as in: 

"INTEGER ARRAY" 

If the identifier is a function name? the type 
specification will be. followed by the word "FUNCTION" as 
in: 

"3 - VECTOR FUNCTION" 


If the identifier has the NAME attribute, the type 
specif icat ion will be preceded by the word "NAME" as in: 


"NAME SCALAR" 


within the first part of the symbol table listing 
which shows the organization of structure templates, the 
"TYPE" field contains additional information to indicate 
the hierarchical relationships which exist within the 
structure templates. For each symbol which is part of a 
structure template, the "level number" of the symbol is 
printed in front of the type information for the symbol. 


3*6*4 "ATTRIBUTES & CROSS REFERENCE" Field 

This field contains all declared attributes of the 
symbol, lists all cross reference information, and 
contains comments about the identifier's use* 

Attributes: This part of the field lists all data 

declaration attributes of variables or labels* In 
addition, special information about structure 
template elements is provided. The possible 
attributes which may appear are: 

ARRAY ( n , n , n ) 

SINGLE 

DOUBLE 

TEMPORARY 

LOCKED 

DENSE 

ALIGNED 

ASSIGN FARM 
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INPUT PARK 

AUTOMATIC 

STATIC 

LATCHED 

INITIAL 

CONSTANT 

ACCESS 

REENTRANT 

EXCLUSIVE 

EXTERNAL 

MONHAL 

<template name >-3TRUCTURE 

Elements of structure templates have their full 
attributes listed in the first part of the symbol 
table listing where they are shown under their 
appropriate template name. In the alphabetized 
second part of the listing, these structure 
template elements will appear again but their 
attributes will not be repeated. Instead the 
notice : 

"#** SEE STRUCTURE TEMPLATE Ctemplate name>" 

will appear directing attention to the hierarchical 
template listing of the structure template whose 
name is given. 

The attributes of a REPLACE MACRO entry will 
contain only the message: 

"MACRO-,TEXT IUDEX = <number > M 

which directs the reader to the appropriate entry 
in the Macro Text Listing for a definition of the 
replace text. 

Cross References: The remainder of the line, 

following any attributes and the word ”XREF : " , is 
devoted to a list of all references to the 
identifier in the format: 

U XXXX 

where XXXX is a four digit specification of the 
line number of the HAL/S statement containing the 
identifier. U is a cross reference flag which 
specifies the identifiers usage: 

Flag Code: N Use of Identifier 

0 Definition 

1 Subscript 

2 Reference 

3 Subscript and reference 

4 Assignment 
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HAL/S COMPILATION 


ISIEHITEICS INC 


MARCH 30, 197Q 


15:25:47.95 
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P ft 0 G B ft Cl LAYOUT 
DEMO: PROGRAM: 

PBOC1: PROCEDURE; 


A 


’ Figure 3-2 The HAL/S Program Layout and Symbol 
& Cross Reference Table Listing 



HAL/S COMPILATION 


INT2RHETRXCS INC 


8ABCH 30, 1974 


SYMBOL 6 CROSS REFERENCE TABLE LISTING? 


(CROSS REFERENCE FLAG KEY: 4 » ASSIGNMENT, 2 = REFERENCE, 1 ■ SUBSCRIPT USE, 0 * DEFINITION) 


DCL NAME 


TYPE 


ATTRIBUTES S CROSS REFERENCE 


7 AA 
7 BB 
7 CC 
7 DD 

7 EE 

8 00 

8 RR 

8 AAREF 
8 SS 
3 A 
11 A 
8 AARBP 
3 B 


STRUCTURE TEMPLATE 
1 MINOR NODE 

2 4X3 MATRIX 

1 MINOR NODE 

2 3X4 MATRIX ARRAY 

STRUCTURE TEMPLATE 
1 MINOS NODE 

2 STRUCTURE 

2 CHARACTER (5) 

INTEGFR 
INTEGER 
STRUCTURE 
INTEGER 


7 BB MINOR NODE 

3 C INTEGFR 


7 CC 
4 D 
7 DD 
1 DEMO 

^ 7 EE 

W * p 

A 

4 G 


4X3 MATRIX 
SCALAR 
MINOR NODS 
PROGRAM 
4 - VECTOR . 

3X4 MATRIX ARRAY 
SCALAR 

SCALAR 


6 H SCALAR 


6 I 
6 J 
6 K 
6 L 

14 LA BE LI 
6 M 


SCALAR 

SCALAR 

3X4 MATRIX ARRAY 
SCALAR 

STATEMENT LABEL 
SCALAR 


9 HY„STBUCTURE 
6 N 

6 0 

2 PRINTER 
10 PROC1 
8 RR 
8 SS 


STRUCTURE (5) 
SCALAR 

SCALAR 

REPLACE MACRO 
PROCEDURE 
MINOR NODE 
CHARACTER (5) 


ALIGNED XREP: 0 

ALIGNED X REF: 0 

SINGLF, ALIGNED 
ALIGNED XPEF: 0 

ARRAY (4) , SINGLE, 
ALIGNED XREF : 0 

ALIGNED XREF: 0 

AA-STRUCTOFE, ALIGNED 
ALIGNED XPEF: 0 0008 


0007 2 0008 

0007 POSSIBLY 
XREF: 0 0007 

0007 POSSIBLY 
ALIGNED 

0008 2 0009 
0008 POSSIBLY 

XREF: 
POSSIBLY 


SINGLE, ALIGNED, STATIC, INITIAL 
SINGLE, ALIGNED, STATIC XPEF: 
♦*** SEE STRUCTURE TEMPLATE QQ 
SINGL£, ALIGNED, STATIC, INITIAL 
1 0024 


NOT USED 
2 0015 2 

NOT USED 
XREF: 0 

NOT USED 
0 00C8 6 

NOT USED 
XREF: 0 
0 0011 2 

IREP; 0 


**** SEE STRUCTUPE TEMPLATE AA 
SINGLE, ALIGNED, STATIC, INITIAL XREF: 0 
1 0020 


0027 

0007 

0015 

0003 

0012 

0003 

0003 


**** .SEE STRUCTURE TEMPLATE AA 
SINGLE, ALIGNED, STATIC XREF: 0 0004 4 0020 

**** SEE STRUCTURE TEMPLATE AA 
XREF: 0 0001 

SINGLE, ALIGNED, STATIC XPEF: 0 0005 4 0024 

**** SEF STRUCTURE TEMPLATE AA 
SINGLE, ALIGNED, "STATIC XREF: 0 0004 2 0027 

***** FRROF ***** PEFERENCEO BUT NOT ASSIGNED 
SINGLE, ALIGNED, STATIC XPEF: 0 0004 2 0027 

***** FRFDP ***** REFERENCED BUT NOT ASSIGNED 
SINGLE, ALIGNED, STATIC XREF: 0 0006 2 0027 

***** FRROF ***** REFERENCED BUT NOT ASSIGNED 
SINGLE, ALIGNED, STATIC XREF: 0 0006 2 0027 

***** EHROF ***** REFERENCED BUT NOT ASSIGNED 
SINGLE, ALIGNED, STATIC XREF: 0 0006 2 0027 

***** ERROR ***** REFERENCED BUT NOT ASSIGNED 
APRAY(F), SINGLE, ALIGNED, STATIC XREF: 

4 0026 2 0027 

SINGLE, ALIGNED, STATIC XREF; 0 0006 2 0027 

***** ERROR ***** REFERENCED BUT NOT ASSIGNED 
XREF: 0 0014 NOT REFERENCED 
SINGLE, ALIGNED, STATIC XPEF: 0 0006 2 0027 

***** ERROF ***** REFERENCED BUT NOT ASSIGNED 
QQ-STRUCTURE, ALIGNED, STATIC XREF: 0 0009 

SINGLE, ALIGNED, STATIC XREF: 0 0006 2 0027 

***** ERROR ***** REFERENCED BUT NOT ASSIGNED 


SINGLE, ALIGNED, STATIC XREF: 0 00C6 2 0027 

***** ERROR ***** REFERENCED BUT SOT ASSIGNED 
MACRO-TEXT INDEX=1 XREF: 0 0002 2 0027 

XREF: 0 0010 NOT REFERENCED 
**** SEE STRUCTURE TEMPLATE QQ 
**** SEE STRUCTURE TEMPLATE 0Q 
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POSSIBLY ROT ASSIGNED 
4 0015 2 0027 

2 0027 

2 0022 4 0023 1 0024 

4 0017 

2 0012 4 0014 2 0023 
2 0014 2 0017 4 0019 
2 0027 
2 0027 


0 0006 2 0020 2 0024 

6 0015 2 0027 


Figure 3-2 (con't.) 
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15:25:^7. 95 


PAGE 7 


tJCL NAR2 TYPE ATTRIBUTES 6 CROSS REFERENCE 

**** SRPOa **** ONE OR BORE VARIABLES REFERENCED BUT HOT ASSIGNED. 

HACRO TEXT LISTING: 

LOC TEXT 

1 6 


9 ) 

A 


Figure 3-2 (con't.) 



HAL/S COMPILATION INTERHETRICS I B C a MARCH 30, 197* 15:25:47.95 

CALLS TO SCAN * 311 

CALLS TO IDENTIFY * 05 
NUMBER OF REDUCTIONS = 866 
MAX STACK SIZE = 11 

MAX TNC. STACK SIZE * 10 
END INC. STACK SIZE = 1 
END ARRAY STACK SIZE = 0 
MAX EXT_AR8AY INDEX * 6 
XREF LIST ENTRIES = 71 
STATEMENT COUNT * 28 

NUMBER OF SYMBOLS * 30 
HI NCR COMP ACTI FI ES * 1 
MAJOR COBPACTIFIES = 0 
MAX NESTING DEPTH = 2 

FREE STRING AREA '* 33063 


END OF HAL/S PHASE 1, MARCH 30, 1974. CLOCK TIME * 15:25:52.46, 

^ 39 CASDS HERE PROCESSED. 

^ ONE ERROR HAS LETECTED IN PHASE 1. 

*\E 

A **** SUMMARY OF ERRORS DETECTED IN PHASE 1 +*** 

ERROR #1 OF SEVERITY 1 IN CROSS-REFERENCE 


TOTAL CPU TIME FOR PHASE 1 0:0:1.93. 
CPU TIME FOR PHASE 1 SET UP 0:0:0.05, 
CPU TIME FOR PHASE 1 PROCESSING 0:0:1.63, 
CPU TIMS FOP PHASE 1 CLEAN UP 0:0:0.25. 
PROCESSING RATE: 1435 CARDS PER MINUTE. 


******* COMPILATION ERRORS INHIBITED TEMPLATE GENERATION 
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Subscript and assignment 
Reference and assignment 
Reference, assignment, and subscript 


Comments: Following the last reference listed for 
each variable, the compiler may insert a comment 
about the variable usage. Possible comments are: 


MOT USED; if the identifier appears in a 
DECLARE statement but is neither referenced 
or assigned. 

{JOT REFERENCED; if the variable is assigned a 
value but never used in any reference 
context . 

MOT ASSIGNED; if the variable value is 
referenced but never appears in any context 
where it can reoeive a value. This is 
obviously an error situation involving the 
use of an uninitialized variable. Therefore, 
the Symbol Table & Cross Reference listing 
contains the error message: 

..***** ER H0R##***REFER£NCED BUT NOT ASSIGNED" 
to call attention to this situation. 


3.7 Macro Table 


Following the cross referen 
listing if any REPLACE defin 
Figure 3 contains a flACRO TEXT 
to the TYPE field in the symbol 
variables, and the TEXT ind 
substituted whenever the identi 
definitions are cross-ref erenc 
which may occur within replacerae 


ces, there will be a MACRO TEXT 
itions appear in the program. 

listing. The LOC field refers 
table listing for REPLACE class 
icates the string which was 
fier was encountered. REPLACE 
ed as well as any identifiers 
nt string. 


3.8 Optional Unformatted Listing 

The primary source listing generated by the HAL/S compiler 
is completely reformatted by the output writer. As a result, 
the source text has lost its relationship to the original card 
image input. 

In order to give the programmer a correlation between the 
primary source listing and his original input, the HAL/S 
compiler will supply an optional unformatted source listing. A 
sample of such a listing is shown in Figure 3*3* 

This option is requested by including the word "LISTINGS” 
in the OPTION field of the JCL (see Section 2.1.3). 
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1 

HI 

DEH0:P80GBAH; 

> 

1 

1 

DEHO 


C| 




2 

DBHO 


C| 

THIS IS A DEHOHSTBATIOH PBOGBAH TO SHOH THE LISTIIG PBOOOCBD BY 


3 

DEHO 


C| 

THE HAL/S-360 COHPILEH 



4 

DEHO 


Cl 




5 

DEHO 

2 

HI 

BEPLACE PBIHTEB BY "6"; 



6 

DBHO 

3 

HI 

DECLAHE IHTEGEB IRITIAL(I) ,A,B,C; 



7 

DBHO 

4 

HI 

DECLABE 0 ,P,G; 



8 

DBHO 

5 

HI 

DECLABE E VECTOR (4) ; 



9 

DBHO 

6 

HI 

DECLABE H,I,J,K ABBAY (S) HATBIX <3 ,4) , L,H, 8,0 

SCALAfi; 


10 

DBHO 

7 

HI 

STEUCTUBB AA: 



11 

DBHO 

7 

HI 

1 BB, 2 CC HATBIX (4,3), 1 DD,2 EE ABBAY (4) HATBIX<3,4) 


12 

DBHO 

7 

H| 

• 


1 

33 

DBHO 

3 

HI 

STBOCTOBB PO: 



14 

DBHO 

8 

HI 

1 BB, 



15 

DBHO 

3 

HI 

2 AABEP AA-STB0CTOBE, 



16 

DBHO 

3 

HI 

2 SS CHABACTEB (5) : 



17 

DSHD 

9 

H| 

DECLABE HY_STHUCTOBE QQ-STBOCTOBE (5) ; 



18 

DBHO 

10 

HI 

PB0C1 sPROCZDDRE; 



19 

PfiOCI 

11 

HI 

DECLABE A IHTEGEB; 



20 

PHOC1 

12 

HI 

IF A=B TBEH DO; 



21 

PBOCl 

14 

hi 

LABEL1 :B*C; 



22 

PBOC1 

15 

HI 

HI_STB0CT0BE. BB. AABEF. DD. EE$(*;3;2,*) * 



23 

PBOCl 

15 

HI 

HY_STBUCTORE. BB. AABEP. BB. CCS <♦ 2) ; 



24 

PB0C1 

16 

HI 

END; 



25 

PBOCl 

16 

B| 

ELSE A“C; 



26 

PBOCl 

18 

HI 

CLOSE PB0C1; 



27 

DBHO 

19 

HI 

DO FOB C - 1 TO 100; 



28 

DEHO 

20 

Ml 

D=KJ(C:2,3) ; 



29 

DBHO 

21 

HI 

BKI); Figure 3-3 The HAL/S 

Unformatted Source 


30 

DBHO 


Listing and Additional Phase I Infoirmation 



HAL 


COMPILATION — PHASE 1 

0 

VFOBHATTED 

S 0 0 B 

C E 

L I 

22 

Hi 

00 CASE A; 


‘ 

1 

31 

DBHO 

22 

HI 

A=B; 



1 

32 

DEHO 

2a 

HI 

E = K$ (B: A , + ) ; 



1 

33 

0BRO 

25 

at 

END; 




34 

DEHO 

26 

HI 

o 

ii 



1 

35 

DBHO 

27 

HI 

WHITE (PRINT2E) HY_S?R 0CT0BE. BE. AAEEF. BB.CC$(3;1 

TO 

3,*), 


36 

DBRO 

27 

HI 

HT^STROCTCBE. EH. AAHEF. DD.BE 



1 

37 

DBHO 

27 

HI 

$|2;2 TO 4:) ,D,E,P,G,H # I,J # K,L,H,N,0; 



1 

38 

DBHO 

28 

Ml 

CLOSE DEHO; 



1 

39 
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Figure 3-3 (con't.) 



RAL/S COMPILATION 


IHTBBMETRXCS INC 


HABCS 30, 1974 


15 x 25347 . 95 


PACE S 


CALLS TO SCAN * 311 

CALLS TO IDENTIFY 3 85 
NUMBER OF REDUCTIONS * 866 
MAX STACK SIZE * 11 

MAX IND. STACK SIZE * 10 
END IND. STACK SIZE * 1 
END AREA Y STACK SIZE * 0 
MAX EXT_ARR AY INDEX = 6 
XREF LIST ENTFIFS = 71 
STATEMENT COUNT 3 28 

NUMBER OF SYMBOLS 3 30 
MINOR CONPACTIFIFS 3 1 
HAJCR COHPACTIFIES 3 0 
MAX NESTING DEPTH - 2 
FREE STRING AREA 3 33063 


END OF HAL/S PHASE 1, MARCH 30, 1974. CLOCK TIRE « 15:25:52.46. 

p ~ 39 CARDS HERE PROCESSED. 

r 1 ORE ERROR WAS CFTECTED IK PHASE 1. 

F' 5 * 

A **** SUMMARY OF ERRORS DETECTED IN PHASE 1 **♦* 

ERROR #1 OF SEVERITY 1 IN CROSS-REFERENCE 


TOTAL CPU TIME FOB PHASE 1 0:0:1,93. 
CPU TIME FOR PHASE 1 SET UP 0:0:0.05, 
CPU TIME FOR PHASE 1 PROCESSING 0:0:1.63, 
CPU TIME FOR PHASE 1 CLEAN UP 0:0:0.25. 
PROCESSING RATE: 1435 CARDS PER MINUTE. 


******* COMPILATION ERRORS INHIBITED TEMPLATE GENERATION 


Figure 3-3 (con’t.) 



3.8.1 Format 


The optional listing contains card images as read 
from the input stream. These images receive no 
compiler-generated annotation* Each card image is 
bracketed by vertical bars (|). 

To the left of each image, the compiler prints the 
card type identification from column one of the input 
card. The HAL/S statement number of the first statement 
included on the card is also printed to the left of the 
card type. This statement number is the same as the one 
assigned to the expanded source by the compiler in the 
primary source listing. 

To the right of the card image, the compiler places a 
sequential card number, one number per card, which simply 
indicates a card's relative position in the input deck. 

Current Scope information is supplied in the same 
manner as in the primary listing. No other information is 
put into the auxiliary listing. This listing does not 
receive any error indication messages. 


3-9 Additional Information 

Immediately following the Macro Text Listing, the compiler 
prints a list of internal statistics for use in compiler 
development. These statistics can be ignored by the 
programmer. 


3.10 Phase II Listing 

The Phase II listing of the HAL/S Compiler identifies 
itself and lists current date and time before entering into the 
code generation process {see Figure 3.4). 

If the 'OPTIONS*' field in the EXEC statement of the JCL 
specifies the 'LIST' option, a listing of all control section 
names needed by the compiled program is prpduced ( see fig. ). 
The format of this listing is typical of IBM model 360 
compilers and translators. 

Following this, a completely formatted object module 
listing will be produced (see fig. 3-4). This listing shows 
the complete code generated for each control section in both 
hexadecimal and pseudo- assembler formats- This is listed 
after a line in the following formats 

ST#n EQU * 
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where n is the compiled HAL/S statement number# and 'ST#n' is 
in the label field. The label field is also used to indicate 
both HAL/S label names and internal branch points in the same 
format as the HAL/S statement number indicator. The comments 
field gives information about the symbolic operand referenced 
by the instruction* 

Following this is a map of relocation information included 
in the produced object module. 

Regardless of whether 'LIST' was specified or not# a 
listing of several performance statistics is printed next* 
These are included to aid in compiler generation# and are of no 
concern to the programmer. 


3.11 Phase III 

The .Phase III listing of the HAL/S compiler identifies 
itself and lists the current time and date before beginning 
construction of the simulation data file. 

If the 'OPTIONS=' field in the EXEC statement of the JCL 
specifies the 'TABLIST' option# the following printout will 
result: 

1) Translation Table - Lists the identification 

codes (decimal and hexadecimal) assigned to 
blocks# symbols# and statements (statement 
#) and gives the associated block name# 
symbol name# and SRN (if present)# together 
with the virtual memory pointer to the 
corresponding file node. 

2) Hex dump of the file# page by page. 

Following the optional TABLIST data# Phase III prints a 
message stating that the SDF has been either created or 
replaced (updated). 

A listing of performance statistics is printed next. 
These are included to aid in compiler generation# and are of no 
interest to the programmer. 
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HAL/S COMPILE? PHASE 2 -- VERSION 360-7.0 OF KAHCH 29, 1974. CLOCK TIRE * 5:57:59.03 

H&L/S PHASE 2 EHTEBED HABCH 30, 1974. CLOCK TIRE * 15:25:56.96 


m 

ts* 

A 


Figure 3-4 
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ESDID NAHE TYPE LENGTH BLOCK NAHE 


0001 SDEMO 

0002 

0003 .DEKO 

0004 SDENO 
0005 ' •frOEflO 

0006 3DBHO 

0007 IOINIT 
OC 08 P121SNP 
0009 BOOT 


0000 000226 DEHO 

0004 0C0C8C PBOC1 

0000 00006B 
OCOO 000070 
0000 000608 
0002 
0002 
C002 
0002 


tn 

&] 

A 


Figure 3-4 



HAL/S COMPILATION 


INIEHEiaiCS IHC 


HARCB 30, 1970 


15;25s47. 95 
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LOCCTR 

CODE 

LABEL 

INSN 

OPERANDS 



000000 


ST# 1 

EQO 

♦ TINE 

— 

39 

000000 


tDEHO 

CS2CT 

ESDID- 

0001 

000000 


DEflO 

EQO 

* 



000000 

47FOF010 


BC 

15,16(0,15) 



OOOOOtt 

000002B8 


DC 

A * 000002B8 B 



000008 

0050 


DC 

X * 00 50 * 



00000 A 

04C4C5D4 


DC 

X 1 04C4C5D4 1 



OOOOOE 

D6 


DC 

X 1 D6 ' 



OOOOOP 

00 


DC 

X'OO* 



000010 

58B0F004 


L 

11,4(0,15) 



000014 

986AB028 


LH 

6,10,40(11) 



000 01 8 

05BB 


BALR 

14,11 



00001A 

0001 


DC 

X»0001« 



00001C 


ST#2 

EQO 

* TINE 

38 

0 

00001C 


ST #3 

EQO 

* TINE 

S 

0 

000398 


jdeho 

CSECT 

ESDIE 

IS 

0005 

000398 

0001 


DC 

X’0001' 



00039A 


ST#3 

EQTJ 

* TIH3 

a 

0 

00039A 

0001 


DC 

X'0001* 



00039C 


ST#3 

EQO 

* TINS 

» 

0 

00039C 

0001 


DC 

X'0001* 



0C039E 


ST #4 

EQO 

♦ TINE 

- 

0 

00039E 


ST#4 

EQO 

♦ TINE 

a 

0 

00039E 


ST #5 

EQO 

* TINE 

= 

0 

000 39E 


ST#6 

EQU 

• TINE 

a 

0 

00039E 


ST #7 

EQU 

♦ TINE 

a 

0 

00039E 


ST#8 

EQO 

* TINE 

a 

0 

000 39E 


ST *9 

EQU 

'* TINE 

a 

0 

00039E 


S T # 1 0 

EQO 

* TINE 

a 

10 

00001C 


IDE NO 

CSECT 

ESDIE 

1* 

0001 

000228 


ADEHO 

CSECT 

ESDID 

i« 

0002 

000228 


PBOC1 

EQO 

* 



000228 

47P0F010 


BC 

15,16(0,15) 



00022C 

0 00002B8 


DC 

A * 000002B8 * 



000230 

0050 


DC 

X *00 50* 



000232 

05D7D9D6 


DC 

X * Q5D7DSD6 • 



000236 

C3F1 


DC 

X * C3F1 * 



000238 

05EB 


BALR 

14 r 11 



00023A 

000 A 


DC 

X 1 000 A* 



00023C 


ST# 1 1 

EQO 

* TINE 

a 

0 

00023C 


ST#12 

EQU 

* TINE 

a 

33 

00023C 

05EB 


BALR 

14,11 



0C023B 

OOOC 


DC 

X’OOOC* 



000240 

4820 AC 06 


LH 

2,6(0,10) 



0CC244 

4920A002 


CH 

2,2(0,10) 



000240 

476F0078 


BC 

6, 120 (15,0) 



0C0250 


ST#1 3 

EQO 

* TINE 

a 

0 

000250 

05EB 


BALR 

14,11 



000252 

000D 


DC 

X'OOOD* 



OC0254 


ST#1 4 

EQO 

+ TINE 

a 

18 

000254 


LABEL 1 

EQO 

* 



OC 02 54 

4820A004 


LH 

2,4 (0,10) 



000258 

4020A002 


STH 

2,2(0,10) 



00025C 

0 5EB 


BALR 

14,11 



00025E 

0 003 


DC 

X'OQOE' 




SYHBOLIC OPERAND 


A 

B 

0002A0 LBL#4 


C 

B 


Figure 3- 4 



RAL/S COMPILATION 


IBTE1HBTSICS ISC 


HABCH 30, 1976 


15s2S:47. $5 


PAGE 12 


LOCCTR 

CODE 

LABEL 

XHSH 

OPERANDS 


STHBOLIC OPERAND 

C00260 


ST SI 5 

son 

* TIRE ~ 

1601 


000260 

41900001 


LA 

9,1 (0 e 0) 



0002 6*1 


LBL65 

EQO 

* 



000264 

1889 


LB 

8,9 



000266 

4C80B04C 


HH 

8,76(0, 11) 


H 1 248* 

0 CO 26A 

1879 


LB 

7,9 



00026C 

4C70B04C 


HH 

7,76(0,11) 


B * 248* 

000270 

4128A0D4 


LA 

2,212 (8,10) 


BY STB0CT0BB»156 

00C274 

4 1 37 AO 38 


LA 

3,56(7,10) 


HY_STEOCTOBE 

000278 

4140000C 


LA 

4,12(0,0) 



00027C 

U1000C04 


LA 

0 » 4 (0,0) 



000280 

45EOCO 60 


BAL 

14,96(0,12) 


V1SBP 

QCO204 

41909001 


LA 

9,1 (0,9) 



000260 

4990B04E 


CH 

9,78(0,11) 


H'5* 

0C028C 

47CF003C 


BC 

12,60 (15,0) 


000264 LBL95 

000290 

05EB 


BALE 

14,11 



0C0292 

000F 


DC 

X * 000F* 



0C0294 


STI16 

EQU 

♦ TIRE * 

0 


000294 

0 5EB 


BA LB 

14,11 



000296 

0010 


DC 

X*0010' 



000298 


STt17 

EQO 

♦ TIRE = 

35 


0CO298 

47PF0084 


BC 

15, 132(15,0) 


0002&C LBLS6 

0 CO 2 AO 


LBL*4 

EQO 

♦ 



0C02A0 

4820A004 


LH 

2,4(0,10) 


C 

0C02A4 

4020A006 


STH 

2,6 (0,10) 


A 

000 2 A8 

0 5EB 


BALB 

14,11 



o\J OC02AA 

0011 


DC 

X'0011* 



A 0002AC 


STt 18 

EQO 

* TIRE * 

10 


CC02AC 


LBLI6 

EQU 

* 



000 2 AC 

05EB 


BALB 

14,11 



0002 AS 

0012 


DC 

X 1 00 12 # 



0002BO 

47F0C004 


BC 

15,4(0,12) 



Q0G01C 


SDEHO 

csscr 

ESDID* 

0001 


00001C 


STS19 

EQO 

* TIME = 

41 


00001C 

41900C01 


LA 

9,1 (0,0) 



000020 


LBL#7 

EQU 

* 



00C020 

4090A004 


STH 

9,4(0,10) 


C 

0C0C24 

05EB 


BALB 

14,11 



0C0 026 

C0 1 3 


DC 

X ' 00 1 3 ® 



0C0028 

u 990 BO 4 A 


CH 

9,74 (0,11) 


H * 100 1 

00002C 

4 72F0058 


BC 

2,88 (15,0) 


000058 LBL#8 

OC 00 34 


ST#20 

EQO 

* TIRE = 

58 


000034 

UC903048 


HH 

9,72(0,11) 


H* 3* 

000038 

8B900C02 


SLA 

9,2 



00003C 

89900002 


SLL 

9,2 



000040 

7829A028 


LE 

2,40 (9,10) 


K*28 

00004U 

7020A008 


STS 

2,8(0,10) 


D 

QC0048 

05EB 


BALB 

14,11 



C0C04A 

0014 


DC 

X * 001 4 1 



00004C 


ST#2 1 

EQO 

* TIRE = 

24 


00004C 


LBLI9 

EQO 

* 



00004C 

41900001 


LA 

9, 1(0,0) 



000050 

4A90A004 


AH 

9,4(0,10) 


C 

000054 

47FP0020 


BC 

15,32(15,0) 


000020 LBL 97 

000058 


LBL *8 

EQO 

* 




Figure 3-4 



HABCH 30, 1974 


15:25:47.95 
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HAL/S COMPILATION 


INTERH3T 


LCCCTR 

CODE 

LABEL 

INSB 

OPERANDS 

0C0C5B 

C5EB 


BALR 

14,11 

0 0005 A 

0015 


DC 

X * 0015* 

00005C 


ST #22 

EQU 

* TIHE 

00005C 

4820AOOO 


LH 

2,0(0,10} 

000060 

05EB 


BALR 

14,11 

000062 

0016 


DC 

X 1 00 1 6 * 

000064 

413POOE4 


LA 

3.228(15,0) 

00C06C 

59201000 


C 

2,0 (0,3) 

OC0070 

472F008A 


BC 

2,138(15,0) 

000078 

8B200002 


SLA 

2,2 

00007C 

4 7DF008A 


BC 

13,138(15,0) 

000084 

58E230C0 


L 

14,0(2,3) 

000 C88 

07F3 


BCR 

15,14 

O0CO3A 


LBLtl 1 

EQU 

* 

0 000 8 A 

U5E0CO18 


BAL 

14,24(0,12) 

OCOC8E 

0D000308 


DC 

A ' CD000308 1 

00C092 


ST #23 

EQU 

* TIHE 

000092 

47FP00F0 


BC 

15,240 (15,0) 

00009 A 


LBL #1 3 

EQU 

* 

00009A 

4820A002 


LH 

2,2(0,10) 

00009E 

4020AOO0 


STH 

2,0 (0,10) 

OOCOA2 

05EB 


BALR 

14,11 

OOOOA4 

0017 


DC 

X 1 00 1 7 * 

0CC0A6 


STt24 

EQU 

* TIHE 

OOOOA6 

47FF00F0 


BC 

15,240(15,0) 

p ~OOCOAE 


LBLtl 4 

EQU 

* 

S&OOOOAB 

4890A002 


LH 

9,2(0,10) 

wfl000B2 

4C90B048 


HH 

9,72(0,11) 

A 0000B6 

4A90AOOO 


AH 

9,0(0,10) 

0000 BA 

8B900002 


SLA 

9,2 

0000B2 

8990CC02 


SLL 

9,2 

0C00C2 

4B90B046 


SH 

9,70(0,11) 

0000C6 

4120A02C 


LA 

2.44 (0,10) 

OOOOCA 

4139A00C 


LA 

3,12(9,10) 

0000CB 

41000004 


LA 

0,4 (0,0) 

000002 

45E0C040 


BAL 

14,64(0,12) 

OOOOD6 

05EB 


BALR 

14, 11 

OCOOD9 

0018 


DC 

X * G0 1 8 * 

0000DA 


ST #25 

EQU 

* TIHE 

0000DA 

47FF00F0 


BC 

15,240(15,0) 

0000E4 


LBL tIO 

EQU 

* 

OOOOE4 

CC00OC02 


DC 

X '00000002* 

OOOOE8 

0000009A 


DC 

A ' 000000 9A * 

0000EC 

000000 AE 


DC 

A ' 000000 AE' 

OOOOFO 


LBLtl 2 

EQU 

* 

OOOOFO 

05EB 


BALR 

14, 11 

0000F2 

0019 


DC 

X 1 0019* 

0000FU 


ST#26 

EQU 

* TIHE 

0P00F4 

41900001 


LA 

9,1 (0,0) 

OOOOF8 


LBLtlS 

EQU 

* 

OOOOF8 

1889 


LR 

8,9 

OOOOFA 

4C80B044 


HH 

8,69(0,11) 

OOOOFE 

89800002 


SLL 

8,2 

000102 

2BOO 


SDR 

0,0 

000104 

4 1 28A00C 


LA 

2,12(8,10) 


95 


35 


256 


17 


481 


ICS INC. 
SYMBOLIC OPERAND 

A 

0000E4 LBL*10 
00008A LBLtl 1 
00008A LBLfll 

EBRSND 

OOOOFO LBLtl 2 

B 

A 

OOOOFO LBLtl 2 
B 

H * 3 * 

A 

H 1 16 ' 

E 

K 

VlSN 

OOOOPO LBL412 

DEHO 

DEHO 

H ' 12 1 
K 


Piaure 3-4 



HAL/S COMPILATION 


INTBRHETRICS ISC 


HASCB 30, 1974 


1 5 : 25 : 47. ®5 


PICE 14 



LOCCTR 

CODE 

LABEL 

I NS 8 

OPERANDS 

SYMBOLIC OPERAND 


000100 

4100000C 


LA 

0, 12 (0,0) 



00010C 

45E0C0F8 


BAL 

14,248(0,12) 

716SN 


000110 

41909001 


LA 

9,1 (0,9) 



000114 

4990B04B 


CH 

9,78(0,11) 

H»5» 


0001 18 

47CF90P8 


BC 

12,240(15,0) 

0000P8 LBLtlS 


0C011C 

0 5EB 


BALR 

14,11 



000 1 1 E 

001 A 


DC 

X * 001 A ' 



0C0120 


ST«7 

EQO 

* TI8E « 1062 



000120 

41100006 


LA 

1, 6(0,0) 



00012U 

4 1 000003 


LA 

0,3 (0,0) 



OCO120 

0 SEC 


BALE 

14,12 



00012A 

00000000 


DC 

A * OOOOOOOO * 

IOINIT 


00012B 

41 30 A3 1C 


LA 

3,796 (0,10) 

HT_STPUCTORE+740 


000 132 

1 84 4 


S 8 

4,4 



000134 

41000003 


LA 

0, 3(0,0) 



000138 

41100003 


LA 

1.3 (0,0) 



00013C 

0 5EC 


BALR 

14,12 



00013E 

00000000 


DC 

A* OOOOOOOO 1 

M21SBP 


000142 

41900001 


LA 

9,1 (0,0) 



000146 


LBLtl 6 

EQO 

* 



000146 

1889 


LH 

8,9 



000148 

4CB0S048 


HH 

8,72(0,11) 

B'3 9 


00014C 

8B80 0002 


SLA 

8,2 



0C0 150 

89800002 


SLL 

8,2 



000 154 

4138A254 


LA 

3.596(8, 10) 

BY_STRDCTORE+540 


000 158 

1B44 


SR 

4,4 



C0015A 

41000003 


LA 

0, 3(0,0) 


A 

CC015E 

41100004 


LA 

1,4 (0,0) 


f\ 

000162 

0 SEC 


BALB 

14,12 



Of 0164 

ooooccoo 


DC 

A * OOOOOOOO * 

B21SHP 


000168 

41909001 


LA 

9,1(0. 9) 



0C016C 

4 990B048 


CH 

9,72(0,11) 

H 1 3 1 


0C0 170 

47CF0146 


BC 

12,326 f1$,0) 

000146 LBLtl 6 


OCO 174 

7800A008 


L3 

0,8 (0,10) 

D 


000178 

05EC 


BALB 

14,12 



00017A 

oooooooo 


DC 

A ( OOOOOOOO * 

BOOT 


000 17E 

4130A02C 


LA 

3,44 (0,10) 

8 


000 182 

1B44 


SR 

4,4 



000184 

41000001 


LA 

0.1 (0 ff 0) 



000188 

41100004 


LA 

1, 4(0,0) 



00018C 

0 5SC 


BALR 

14,12 



0C018E 

OOOOOOOO 


DC 

A’OOOOOOOO* 

H21SNP 


OC0 1 92 

78COAOOC 


LE 

0,12(0,10) 

F 


OCO 1 96 

0 5SC 


BALB 

14,12 



000198 

COOOOCCO 


DC 

A • 0 3000000 * 

BOOT 


00019C 

7800 A0 1 0 


LE 

0,16 (0,10) 

G 


000 1 AO 

0 5EC 


BALB 

14,12 



000 1 A 2 

ooooocco 


DC 

A ' OOOOOOOO * 

BOOT 


0C01A6 

780 0 A0 14 


LE 

0,20(0,10) 

H 


OC 0 1 AA 

05EC 


BAfcR 

14,12 



0 CO 1 AC 

oooooooo 


DC 

A * OOOOOOOO 1 

BOOT 


000180 

7800A018 


LE 

0,24 (0,10) 

I 


0001B4 

OSEC 


BALB 

14,12 



0001B6 

OOOOOOCO 


DC 

A * OOOOOOOO 1 

EOUT 


000 1 BA 

7800A01C 


LE 

0,28 (0,10) 

J 


Figure 3-4 



HAL/S COMPILATION 


INTEBHBTRICS INC. 


MARCH 30, 1974 


15:25:97. 95 


PAGE 15 



LOCCTR 

CODE 

LABEL 

INSN 

OPERANDS 

SYMBOLIC OPERAND 

000 1 BE 

05SC 


BALB 

14,12 


OOOICO 

00000000 


DC 

A'OOOOOOOO* 

BOOT 

C001C4 

41900001 


LA 

9,1 (0,0) 


0C01C8 


LBLS17 

EQO 

* 


000 1C0 

1889 


LB 

8,9 


000 1 CA 

UC80B044 


HH 

8,68 (0,11) 

BM2* 

0C01CE 

89800002 


SLL 

8,2 


CCO 1D2 

4138AOOC 


LA 

3,12(8,10) 

K 

000 1D6 

1844 


SB 

4,4 


0001D8 

41000003 


LA 

0, 3(0,0) 


000 1 DC 

41100004 


LA 

1, 4(0,0) 


000130 

0 SEC 


BALR 

14,12 


0001E2 

ccoooooo 


DC 

A ' OOOOOOOO * 

H21SNP 

0001E6 

41909001 


LA 

9,1 (0,9) 


000 1 EA 

4990B04E 


CH 

9,78 (0,11) 

H * 5 * 

000 1EE 

47C701C8 


BC 

12,456 (15,0) 

0001C8 LBLf 17 

OC01P2 

7800A020 


LE 

0,32(0,10) 

L 

0001F6 

0 SEC 


BALB 

14,12 


0C01F8 

ooooooco 


DC 

A'OOOOOOOO* 

EODT 

000 1 FC 

7800A 0 24 


LE 

0,36(0,10) 

H 

0C02C0 

05EC 


BALR 

14,12 


000202 

00000000 


DC 

A 1 OOOOOOOO * 

EODT 

000206 

7800 AO 28 


LE 

0,40(0,10) 

N 

CC020A 

0 SEC 


BALB 

14,12 


00020C 

00000000 


DC 

A'OOOOOOOO* 

EODT 

C00210 

7800A02C 


LE 

0,44 (0,10) 

0 

000214 

OSEC 


BALR 

14,12 


0C0216 

00000000 


DC 

A'OOOOOOOO* 

SOOT 

000 2 1 A 

05E8 


BALB 

14,11 


000 2 1C 

0018 


DC 

X * 00 1 B 1 


00021E 


ST#28 

EQO 

* TIME = 10 


000 2 1 E 

05EB 


BALR 

14,11 


000220 

001C 


DC 

X'OOIC' 


000222 

47FOC004 


BC 

15,4(0,12) 


0002B8 


JDESO 

CSECT 

ESDID- 0003 

% 

0002B8 

47F0C174 


BC 

15,372(0,12) 

STRACE 

O002BC 

00000398 


DC 

A ' 00000 398 ' 


OC02C0 

00000328 


DC 

A ' 00000 328' 


0002C4 

FF000324 


DC 

A • FF00P324 ' 


OC02C8 

00000000 


DC 

A'OOOOOOOO* 

DEMO 

0002CC 

0001 


DC 

X'0001* 


0002CE 

001C 


DC 

X*001C* 


0002DO 

00000000 


DC 

X'00000000* 


000204 

oooooooo 


DC 

X'00000000* 


0002D8 

00000000 


DC 

X'00000000* 


0002DC 

oooooooo 


DC 

x*oooooooo* 


0C02E0 

00000398 


DC 

A * 00000398 * 


0CO2S4 

00000398 


DC 

A ' 00000398* 


0002E8 

00000398 


DC 

A ' 00000398 ' 


00C2EC 

00000398 


DC 

A * 00000398 ' 


0C02F0 

00000398 


DC 

A ' 00C 00398 * 


0002F4 

00000001 


DC 

X*00000001* 


OC02F8 

OOOOOOOO 


DC 

A'OOOOOOOO* 

aDEao 

0002FC 

oooc 


DC 

x*oooc* 


0002FE 

0010 


DC 

X*0010» 



Figure 3-4 





HAL/S 

COM PILATION 


INTER 

H E T B I 

C S ISC. 

HARCB 30, 1974 

15:25:47. 95 

PAGE 

LOCCTR 

CODE LABEL 

ISSN 

OPERANDS 


STHBOLIC OPERAND 




000 300 

0003 

DC 

X * 0003 1 






0C0302 

0064 

DC 

X *0064* 






000304 

00F8 

DC 

X'C0F8* 






000306 

0005 

DC 

1*0005* 






OCO3O0 

1AC3C1E2 

DC 

XMAC3C1E2* 






00030C 

C 540S5C1 

DC 

X *C540E5C1 * 






000310 

D9C9C1C2 

DC 

X* D9C9C 1 C2 * 






000314 

D3C540D6 

DC 

X* D3C540D6' 






000318 

E4E340D6 

DC 

X * E4E340D6 * 






0C031C 

C640D9C1 

DC 

X * C640D9C1 ' 






000320 

D5C7C5 

DC 

X * D5C7C5 * 






000328 

SDEHO 

CSZCT 

END 

ESDID= 

0004 






A 


Figure 3-4 



HAL/S COMPILATION IKTERBBTRICS I 


RID POS 

REF 

FLAG 

ADDRESS 

0001 

0009 

CB 

000217 

0001 

0009 

08 

000 20D 

0001 

0009 

08 

000203 

00 01 

0009 

ce 

0001P9 

0001 

0008 

08 

0001E3 

0001 

0009 

Cfl 

0001C1 

0C01 

0009 

08 

0001B7 

0001 

0009 

CB 

0 00 1 AD 

0001 

0009 

08 

000 1 A3 

C001 

0009 

C8 

000199 

0001 

0008 

ce 

00018F 

0001 

0009 

08 

0001 7 B 

0C01 

0008 

08 

000165 

0001 

0008 

08 

0Q013F 

0001 

0007 

08 

00012B 

0001 

0001 

C8 

000CED 

0C01 

0001 

08 

0OOG29 

0001 

0003 

08 

00008F 

0001 

0003 

ce 

000C05 

0C02 

0003 

08 

00022D 

0003 

000 6 

08 

0002P9 

0003 

0005 

C8 

000 2F1 

0003 

0005 

C8 

000 2ED 

0003 

0005 

C8 

0002E9 

0003 

0005 

C8 

0002E5 

0003 

0005 

C8 

0002E1 

0003 

0001 

08 

0002C9 

0003 

0004 

C8 

0002C5 

0003 

0004 

08 

0002C1 

0003 

0005 

08 

0002BD 


LOC 8 DISP NAME 

UNDER DEMO 
000398 A 000 A 

00039A A 002 B 

0CO39C A 004 C 

0 00 3 AO A 030 D 

0003A4 A 00C F 

0003A8 A 010 G 

0003C8 A 02C E 

0003AC A 014 H 

0003BO A 018 I 

0CQ3B4 A 01C J 

0003D8 A 00C K 

0003B8 A 020 L 

0003BC A 024 N 

0G03C0 A 028 N 

0003C4 A 02C 0 

0004C8 A 038 HY_STRUCTDRB 

UNDER PBOCl 
00039E A 006 A 


Fiaure 1-4 
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INST8UCTION FREQUENCIES 

ISSN COUNT 
6 ALB 15 

BCB 1 

LB 5 

SB 4 

SDH 1 

STB 4 

LA 34 

BAL 4 

BC 13 

LK 6 

CH 6 

AH 2 

5 H 1 

HH 7 

L 2 

C 1 

STE 1 

LI 11 

SLL 5 

SLA 4 

LH 1 


*** CONVERSION ERRORS INHIBITED EXECUTION 
gtj 102 HALBAT OPERATORS CONVERTED 
A 920 BITES OF PROGRAM, 1544 BITES OF DATA 


MAX. OPERAND STACK SIZE =7 

END OPERAND STACK -SIZE =0 

NUMBER OF STATEMENT LABELS USED =17 
MAX. STORAGE DESCRIPTOR STACK SIZE =0 
END STORAGE DESCRIPTOR STACK SIZE =0 
NUMBER OF MINOR COHPACTIFIE5 =1 

NUMBER OF MAJOR COMPACTIFIES =0 


END OF HAL/S PHASE 2 MARCH 30, 1974. CLOCK TIME * 15:26:4.76 

TOTAL CPU TIME FOR PHASE 2 0:0:1.43 

CPU TIME FOR PHASE 2 SET UP 0:0:0.03 

CPU TIME FOR PHASE 2 GENERATION 0:0:0.35 

CPU TIME FOR PHASE 2 CLEAN DP 0:0; 1.05 


Figure 3-4 



4. DEBUGGING AIDS 


4,1 Compilation Errors 


4.1,1 Message Format 

When Phase 1 of the HAL/S compiler (the syntax 
checking phase) detects an error condition, a diagnostic 
message is placed in the primary source listing at the 
point of detection. These error messages have the 
following form: 

***** c ERROR #n OF SEVERITY s, ***** 

***** text of message 
In this message: 

c a mnemonic error name uniquely identifying 
this error message (see Sec, 4,1.2) 

n ? indication that this is the nth error in the 
current compilation 

s = severity of error (see Sec, 4.1.3) 

For error messages other than the first in a given 
compilation, the following line is placed after all error 
messages referring to a particular HAL/S statement: 

***** LAST ERROR WAS DETECTED AT STATEMENT m ***** 

where m is the HAL/S statement number of the most recent 
previous statement that received an error message. 


4.1.2 Classification Scheme 

Each error message that may be generated by Phase 1 
of the HAL/S compiler has a unique mnemonic designation 
which appears in the error printout. These mnemonics have 
been assigned according to general error-type classes. 
The first letter of each error message mnemonic indicates 
the major class to which the error belongs (see Appendix 
D). The second letter, if present, indicates a sub-class 
further describing the error. These one or two letters 
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are followed by a number which simply indicates members of 
a class-subclass group. The table at the beginning of 
Appendix D shows the meaning of the possible letter 
combinations . 


4.1.3 Error Severity 

The severity indication in the error message shows 
the effect of the error on the compilation process. The 
possible severities and their effects are as follows: 

0 = warning (compilation proceeds normally) 

1 = error (compilation proceeds, execution prevented) 

2 = severe error (syntax check continues, 

code generation prevented) 


>2 = abortive error (compilation halts immediately) 


4.1,4 Phase I Error Summary 

Hear the end of the Phase I source listing and table 
printout, a summary of detected errors is printed in the 
following form, 

END OF HAL/S PHASE 1, <date>. CLOCK TIME = <time> 
n CARDS WERE PROCESSED, 

x ERRORS WERE DETECTED. THE MAXIMUM SEVERITY WAS y. 


THE LAST 

ERROR 

DETECTED 

WAS 

AT 

STATEMENT 

' z. 

##*«# SUMMARY 

OF 

ERRORS DETECTED 

IN 

[ PHASE 1 

«**«* 

ERROR 

#1 

AT 

STATEMENT 

el 

OF 

SEVERITY 

si 

ERROR 

#2 

AT 

STATEMENT 

e2 

OF 

SEVERITY 

s2 


4.1.5 Phase II Errors 

Phase II of the HAL /S compiler (the code generation 
phase) may also produce some error messages (see Sec. 

3.6). These messages have the form: 

*** ERROR #1 DURING CONVERSION OF HAL/S STATEMENT n 
text of message 4 . 2 
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where n is the HAL/S compiler-assigned statement number^to 
which the error refers. Following these specific 
messages, Phase II supplies a disposition message 
indicating the total effect of all Phase II messages on 
the compilation. 


4.2 Execution Errors 


4,2.1 Introduction 

This section describes how error handling has been 
implemented in the HAL/S 360 system. In the HAL /S system 
every error is assigned a non-zero positive number. There 
are two classes of errors: 

i) system-defined errors, (1-99) which arise as^a result 

of failure during the execution of a user's program, 
and are signalled internally; 

ii) user-defined errors, (100-120) which are signalled by 
the user through a SEND ERRORn statement. 

System-defined errors may also be signalled by the user 
through a SEND ERRORn statement. 

The HAL/S Error Processor processes all errors and 
determines what action is to be taken. The user can gain 
control after an error by means of the ON ERRORn GO TO xxx 
statement, or leave the system in control by default or by 
means of the ON ERRORn SYSTEM statement. Additionally, 
the user can specify that the HAL/S Error Processor take 
no action for a specific error by means of the ON ERRORn 
IGNORE statement. These three possible actions will be 
referred to as GO TO action, SYSTEM action, and IGNORE 
action respectively. 

In the following sections, the error format given 
shows the maximum information printed. If the compile time 
TRACE option is not in effect then there will be no 
information on the statement number of the last HAL/S 
statement to be executed. 


4.2.2 GO TO Action 

If the user has requested control for a particular 
error via a HAL/S ON ERROR GO TO statement, control is 
transferred to the appropriate location. If the runtime 
parameter MSGLEVEL has been specified with a value greater 
than zero, the following message is printed: 

SS< 4 - 3 
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***HAL ERROR n - (message) — Xlocation) 

LAST STATEMENT WAS m 

TRANSFER TO GO TO label —Xlocation) 
a# 

If the MSGLEVEL value is zero, no message is printed. 
Certain errors cannot result in GO TO action. If such an 
error occurs after the error has been specified in an ON 
ERROR GO TO statement, SYSTEM action ensues. 


4.2.3 SYSTEM Action 

One of three possible SYSTEM actions may ensue: 

UNLIMITED - The standard fixup for ERRORn is taken 
and the following message is printed: 

***** HAL ERROR n - (message) — > (location) 

LAST STATEMENT WAS m 

STANDARD FIXUP, EXECUTION RESUMED 

where (message) is the error text corresponding 
to ERRORn. The last HAL/S statement to be fully 
executed is specified by m and the address of 
the error is specified by (location). Following 
this, the Error Processor returns control to the 
user's program, 

LIMITED - The error count for ERRORn is updated. 

If it equals or exceeds a user-set maximum count 
(refer to the the ERRORLIM option in Appendix B. 

- note that this is applied to all LIMITED type 
errors for which SYSTEM action is specified), 
the following message is printed: 

****** HAL ERROR n - (message) --> (location) 

LAST STATEMENT WAS m 
ERROR COUNT EXCEEDED 

and execution of the user's program abnormally 
terminates. 

Otherwise, if the maximum count is not 
exceeded, the standard fixup for ERRORn is taken 
and the following message is printed: 

***** HAL ERROR n - (message) --> (location) 

LAST STATEMENT WAS m 

STANDARD FIXUP, EXECUTION RESUMED 

and the Error Processor returns control to the 
user's program. 

In both cases, (message) is the text for 

(B?< 
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ERRORn, (looation) is the address where the 
error occurred, and m is the last HAL/S 
statement to be fully executed* 

TERMINATE - The following message is printed: 

***** HAL ERROR n - (message) (location) 

LAST STATEMENT WAS m 
SYSTEM ACTION IS TERMINATE 

where (message) is the text for ERRORn, 
(location) is the address where the error 
occurred, and m is the last HAL/S statement to 
be fully executed. Following this, execution of 
the user's program abnormally terminates. 

Note that the form of the SYSTEM action and 
standard fixup is specified for each error message 
in Appendix E. 


4.2.4 IGNORE Action 

If a particular error has been specified in a HAL/S 
ON ERROR IGNORE statement, the occurrence of the error 
causes the standard fixup for the error to occur. 
However, no message is generated and the occurrenceof the 
error does not contribute towards the termination error 
count for that error. Certain errors cannot be ignored. 
If speh an error occurs after an ON ERROR IGNORE statement 
has been executed for the error, SYSTEM action ensues. 


4.2,5 The Error Summary 

Whether execution terminates normally or abnormally, 
if there were any errors signalled either internally or by 
the user, a summary in the following form is printed on 
the output channel defined by the MCHAN RUNPARM option 
( see Appendix B ) : 

*** SUMMARY OF ERRORS •«« 

ERROR# SYSTEM GOTO IGNORE 

<e> <ne1> <ne2> <ne3> 


where <e> is an error number and <ne1>,<ne2>, and <ne3> 
are the individual counts, by action type, for the error. 

If the MSGLEVEL parameter has a value greater than 

SSc't-s 
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zero and if no errors occurred, the following message is 
printed : 


NO ERRORS OCCURRED IN THIS RUN 


4.3 Execution Dumps and Traces 

When an executable form of a HAL/S program (or program 
complex) has been produced by the HALLINK program as described 
in Section 2, its execution may be carried out in one of two 
ways : 

1) direct execution of the program; 

2) execution of the program under control 
of an execution monitoring system. 

In either mode of execution, actual operation of the HAL/S 
program is identical. The differences between the two modes lie 
in the type and degree of diagnostic aids available. 

4.3.1 Direct Execution 

Direct Execution of a HAL /S program is achieved by 
naming the program in the PGM= field of an EXEC card of an 
OS/ 36 O job step. This type of execution is automatic if 
the HALSLG or HALSCLG catalogued procedures of Appendix C 
are used. Parameters may be passed to the module via the 
PARM field or, if the catalogued procedures are used, via 
the RUNPARli field. The legal parameters and their effects 
are listed in Appendix B with one exception: the DUMPs 

parameter has no effect under direct execution. This 
means that no dump of HAL/S variables may be obtained 
(even during abnormal termination) when a HAL/S program is 
executed directly. HAL/S variable dumps may be obtained by 
running under the execution monitoring system described 
next in Section 4,3.2 Under direct mode, all features of 
the simulated Real Time executive (see section 5) are 
available since the necessary routines are made part of 
the HAL/S load module during the HALLINK step. 

4.3.2 The Execution Monitoring System 

To obtain the most complete diagnostic capability, 
the user may run a HAL/S load module under control of the 
execution monitoring system. Execution in this mode is 
produced by using the HALSCLD and HALSLD catalogued 
procedures in Appendix C. Under this mode, initial 
execution control is given to a montitor program (RUNMON) 
by specifying RUNMON in the PGM= field of the EXEC card. 
RUNMON is a processing program supplied with the basic 
HAL/S-. 36 O compiler system. 
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RUNMON performs two basic tasks: 


1) loading and execution of a diagnostic 
request processor; 

2) loading and execution of a HAL/s program 
as directed by the inputs to the diagnostic 
request processor. 

Under this system, the user indicates diagnostic 
requests via an input dataset. The dataset is indicated in 
the J CL of the execution step as: 

//GO. REQUESTS DD * 


Crequest cards> 


/* 

The REQUEST DD card may also indicate any existing dataset 
into which the requests have been previously stored. 

Under Release 7 of the HAL/S-360 Compiler System* the 
requests which may be made are quite simple. ihe legal 
requests are : 

EXECUTE <module name> 

PARAMETERS '<run time options>'; 

<module name> is the name of the load module which 
contains the HAL/S program to be executed. The specified 
module is loaded from the dataset indicated on the HALMOD 
DD card. In the above illustration, Cruntime options> is a 
set of options as described in Appendix B. All options may 
be specified including requests for dumps of HAL/S 
variables . 

If the HALSCLD catalogued procedure were used to 
compile, link, and execute a HAL/S program, the following 
REQUESTS DD card could be used: 

//GO. REQUESTS DD * 

EXECUTE TEHPNAME 

PARAMETERS 'TRACE=M , DUMP=2 ' 

/* 

The EXECUTE request indicates a module named 
TEMPNAME. This name is the default module name generated 
by HALLINK is specific HALLINK requests to change the 
default are not made. (Changing the module name may be 
accomplished by the inclusion of a NAME card in the 
HALLINK input stream, or by specifying a member name on 
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the SYSLNOD DD card in the HALLINK step.) The above 
PARAMETERS request indicates that executive tracing of 
realtime activity (TRACED) and an unconditional 
termination dump (DUMP=2) are to be provided. 

Note that to perform any type of dump activity, the 
execution monitoring system must be provided with the 
Simulation Data Files (SDF) for any HAL/S compilation 
units for which dumps are expected. These SDF datasets are 
specified vis the HALSDF DD card. See Section 2 for more 
information about the creation and saving of SDF's, 

The RUNMON first loads and executes the diagnostic 
request processor which reads and interprets the requests 
from the REQUESTS DD card. The module indicated in the 
EXECUTE request is then executed under control of the 
special requests given in the PARAMETERS request. If a 
REQUESTS DD card is defined, any information found in the 
PARM field passed to the RUNMON program is ignored. 

In future releases of the system, many of the 
requests which are now specified in the PARAMETERS option 
will be expanded and will allow much more detailed control 
of diagnostics. This will in general be done by removal of 
options from the set of legal options in Appendix B and by 
definition of new legal inputs on the REQUESTS DD card. 
The future requests will be made via a diagnostic language 
which will allow such actions as tracing of single 
statements and dumps of specified variables at specific 
points of execution, including dumps based on time. 

An alternate method for executing a HAL/S program 
under control of the execution monitoring system has been 
defined. If no REQUESTS DD card is present when the RUNMON 
program is executed, certain default actions will take 
place : 

1 ) the HAL/S module to be executed is presumed to 
have the name TEMPNAME; 

2) any PARM field information provided to the RUNMON 
program is used as if it had been found on a 
PARAMETERS request card. In the HALSCLD and HALSLD 
procedures, the term field may be specified via the 
RUNPARM JCL option. 


This alternate system allows users to run their HAL/S 
programs under the execution monitoring system in much the 
same way as they can under the direct execution mode. If 
the user is doing initial debugging of a new program, 
simply changing the name of a catalogued procedure being 
used from HALSCLG to HALSCLD will provide identical 
program behavior, but will provide the benefit of a dump 
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of all HAL/S variables in the event of an abnormal 
termination . 

4.3.3 Location of Diagnostic Output 

Any printed output generated by the HAL/S runtime 
system in either direct execution or execution under the 
execution monitoring system is sent to the dataset defined 
as the message dataset for the run. This dataset defaults 
to the one indicated on the CHANNEL6 DD card and may be 
altered by the MCHAN option as described in Appendix B. 
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5 . HAL/S REALTIME PROGRAMS 


5.1 Using the Real-Time Features of HAL/S-360 

5.1.1 Introduction 


The Real-Time features of HAL/S-360 - SCHEDULE, WAIT, 
SIGNAL, etc. - have been implemented in Releases 360-4 and 
360-5. This section supplements Chapter 8 of the HAL /S Language 
Specification with details about compilation and run-time 
options, timing, and executive trace mode messages. 


5.1.2 Terms and Concepts 


Process : 

The dynamic entity created when a SCHEDULE 
statement is executed. 

Program. Task: 

The static blocks which are scheduled and 1 
executed as processes; the only allowed object of a 
SCHEDULE statement. 

Priori tv : 

A number, implicitly or explicitly assigned to 
a process when it gets scheduled, and changeable by 
the UPDATE PRIORITY statement, that determines which of 
two or more ready processes is executing.' A higher value 
indicates greater importance. In HAL/3-360, priority may 
range from 0 to 255. A value specified outside this range 
results in a value MOD 256 with no error message. The 
priority of the. initial process is 50. 

Process Queue:.. 

A list of active processes ordered by 
priority. 
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Process States: 


a) Inactive: A non-existent process. A program or 

task block that has not yet been scheduled or has 
been terminated. 


b) Active : The process exists on the process queue. 

A process becomes active when it is scheduled. An 
active process may be waiting, ready, or 
A process remains excuting until it 
terminates in any of several ways. 

c) Waiting : The process is unable to execute because 

some condition has not been met. Different kinds 
of conditions exist: 


1 ) 

time ; 


2) 

event expression; 


3) 

completion of dependent 

processes ; 

4) 

the use of an exclusive 

procedure. 

ft.ead.yj . 

The process is able to 

execute but 


is not because some other process is executing. 


e) Executing : The process is progressing through a 

sequence of HAL statements via CPU control. 

Process Swap: A process state transition where 

one process leaves the executing state and 
another process changes from ready to 
executing. This may be due to the first 
process entering the wait state or inactive 
(terminated) state, or because the second 
process has a higher priority. 

Breakpoint : A place in the code sequence at which 

the existence of a higher priority ready 
process is allowed to cause a process swap. 
Currently in HAL/S-360, this is at the end of 
every statement. 
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Event . (variable): A HAL variable with a boolean 

ON/OFF (or TRUE/FALSE) value. The value (or 
state) of an event variable is under 
programr.ier control via the SIGNAL, SET, and 
RESET statements. Process event variables 
process values that indicate the state of the 
associated process: active-ON, inactive- 

OFF. 

Event expression: A logical combination of event 

variables (using AND, OR, NOT) which 
specifies a condition for which a process may 
wait or be cancelled. 

HAL/S-R60 load module: An OS/ 36 O load module 

which is the result of the HALLINK step. It 
contains one or more HAL compilation units 
(program, comsub, or compool) and all modules 
in the run-time library to which they refer. 
It runs under OS/ 36 O as a single OS task. 

Termination or Completion: The transition of a 

process to the inactive state; its removal 
from the process queue. 


a) Normal: V/ hen an executing process reaches 
the highest level RETURN or CLOSE statement 
in the program or task, it automatically 
waits for the completion of all its dependent 
processes, if any exist. Following this, the 
process is terminated provided it is not 
cyclic (scheduled with a REPEAT option). If 
it is a cyclic process, it is prepared for 
another cycle of execution, unless it has 
been cancelled (see below). 


b) Cancellation: This provides a safe way to 
stop a cyclic process. If a process has not 
yet begun execution or is between cycles of 
execution, cancellation causes immediate 
termination. If a process has begun but not 
yet completed a cycle, cancellation causes 
normal termination, as above, at the end of 
the current cycle. Thus, cancellation does 
not affect non-cyclic processes which have 
already begun execution. Cancellation can 
occur in three ways: 

1) a CANCEL statement; 


(/ 


5-3 


INTERMETRICS INCORPORATED * 701 CONCORD AVENUE • CAMBRIDGE, MASSACHUSETTS 02138 • (617) 661-1840 



2) at a time specified in the UNTIL <time 
value> expression on the SCHEDULE 
statement ; 

3) by an UNTIL or WHILE event expression on 
the SCHEDULE statement (see HAL/S Language 
Specification for the special case when 
using UNTIL <event expression> ) . 


c) Abnormal: Immediate termination of a process and 
all its dependent processes, if any exist, occurs 
only as the result of a TERMINATE statement. The 
process(es) may be in any of the active states. 
Clean-up measures during termination guarantee that 
all system resoures are freed, but the result with 
regard to values of COMPOOL variables and the effects 
of partial completion of specific computations and 
control sequences are unpredictable. If this proves 
to be a problem, the language specification and 
implementation of TERMINATE could be changed to allow 
execution of block-level specific clean-up procedures 
via the ON ERROR GO TO mechanism. 


Real Time Executive: Those routines in the library which 

implement the real time features of HAL/S-360, This 
includes : 

a) a process manager which selects and executes ready 
processes and controls cyclic execution and normal 
termination ; 

b) timer handling routines; 

c) event handling routines; 

d) process service routines corresponding to the real 
tine statements. 

5,1.3 Timing 


The timing implied by the real time statements and 
returned by the built-in function RUNTIME is an AP-101 
pseudo-time in units of seconds. The pseudo-time is 
maintained in HAL/S-360 by a post-statement processor in 
the run-time library that is called at the end of each 
executable statement. The compiler will assign a time cost 
for each statement in terms of an integral number of 
micro-second timer units based on the generated code 
sequence. There is a global constant which is the number 
of these units in one second of CPU operation. This 
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conversion number is modifiable by the SPEED Execution 
option . 


A pseudo interval timer which contains the number of 
machine cycles until the next timed action is decremented 
at the end of each statement by its time cost. When the 
timer is decremented to or through zero, a pseudo- 
interrupt routine is called which takes the appropriate 
actions, including re-loading the timer with the interval 
to the next timed action on the timer queue. 


HAL variables which contain absolute or relative time 
values should be declared as single or double precision 
scalars. The timer routines maintain time in double 
precision floating point seconds. 


Both the initial time value at the start of a HAL run 
and the constant equating machine cycles per second are 
under control of the programmer via PARM field options 
( see Below) . 


5.1.4 PARM Field Options 

See Section 2.1.3 and Appendix B of this manual for 
other compile-time and run-time options. 


5.1,5 Compile Time 

The compile time TRACE option must be specified to 
get the compiler to include the calls to the pseudo-time 
statement processor. Without this, the pseudo-time will 
not advance properly. 


5.1.6 Execution Time 

1) SIMTIMEs number: initial pseudo-time value 

( DEFAULT=0 ) 

2) SPEED = number: timer units per second 

(DEFAULT = 10,000,000). 

3) PCBS = number: maximum number of simultaneously 

Active processes (DEFAULT = 10). 

Note: This parameter will be eliminated in a later 

compiler release when the value will be set 
automatically to the total number of programs and 
tasks in the HAL/S-360 load module. 
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4) TRACE = 4: Specifies a mode of tracing where all 
’’significant interactions in the Real Time Executive 
are printed on the message channel. The format of 
these trace messages is: 

#*#RTC TRACE: TIME = <time> <process-id> - <message> 

where <time> is the current value of the pseudo - 
time in seconds; <process-id> is PROGRAM name 
(priority) or TASK name (priority); and <message> is 
the action being taken. The different messages and 
their meanings are listed in the next section. 


5.1.7 List of Real Time Messages 


1) READIED FROM WAIT: wait type 

A condition, indicated by ’’wait type”, for which the 
process was waiting has occuredi The named process 
can now compete for CPU execution based upon its 
priority . 

2) SCHEDULED 

A SCHEDULE statement creating the named process was 
successfully executed. 

3) INITIATED 

The process is about to become executing for the 
first time since being scheduled. 

4) RESUMED 

The process is about to become executing after being 
readied from a wait state or suspended at a 
breakpoint . 

5) AT RETURN OR CLOSE 

The process finished normally. What happens next 
depends on whether or not there were any active 
dependents (if so, it enters a wait state - message 
#11), and whether or not it was scheduled with a 
REPEAT option (if so, it is either repeated 
immediately - message #6, or put into an inter-cycle 
wait state - message #11, or terminated, if it has 
been cancelled or if it is not cyclic - message #9). 

6) REPEATED 
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A process scheduled with the REPEAT option is about 
to begin another cycle of execution. The beginning of 
the first cycle is traced with the INITIATED message. 

7) FASTTIME 

This indicates that the process manager discovered no 
ready processes, but there was at least one process 
waiting for a future time. The pseudo-time is 
advanced to that time so that work can be done. 

(Note that no <process-id> appears with these 
messages because the action does not relate to a 
specific process.) 

8) END OF RUN 

There are no active processes. There is no more work 
to do and none can be generated. 

(Note that no <process-id> appears with these 
messages because the action does not relate to a 
specific process.) 

9) TERMINATED 

The process was terminated because of one of the 
following : 

a) a TERMINATE statement was executed; 

b) normal termination occured; 

c) cancellation resulted in termination. 


10) CANCELLED (CANCEL) 

The process was canceled via the CANCEL statement. 

The TERMINATED message may or may not follow 
immediately, depending upon the state of the process. 

11) ENTERED WAIT: wait type 

The process entered the wait state either explicitly 
with a WAIT statement or implicitly at the beginning 
of an exclusive procedure, or at the RETURN or CLOSE 
at the highest level. 

12) SIGNALLED EVENT 

The process executed a SIGNAL statement. If the 
change of state of the event variable had any effect, 
further messages will follow. 

•?«*< 5-7 
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13) SUSPENDED AT BREAKPOINT 

The process manager suspended execution of a process 
because there was a higher priority process, 

14) PRIORITY UPDATED 

An UPDATE PRIORITY statement was executed, changing 
the priority of the process. 

15) CANCELLED (EVENT) 

The cancel condition specified in the UNTIL or WHILE 
<event expression> phrase of the SCHEDULE statement 
which created the process has been satisfied. 

16) CANCELLED (time) 

The cancel time specified in the SCHEDULE UNTIL 
phrase has arrived, 

17) SET/REST (event) 

A SET or RESET statement altered the state of an 
event variable. Any effect will be indicated in 
following messages. 


5.1.8 List of Real Time Wait-Types 

The wait types and the statements causing them are: 


Wait Types in Trace Message Statements 


1. TIME 

2. UNTIL TIME 

3. FOR EVENTS 

4. SCHED IN TIME 

5. SCHED AT TIME 

6. SCHED ON EVENTS 

7. FOR DEPENDENTS 

8. FOR DEPENDENTS 


WAIT <value> 

WAIT UNTIL <value> 

WAIT UNTIL 
<event expression> 

SCHEDULE X IN <value> 

SCHEDULE X AT <value> 

SCHEDULE X ON 
<event expression> 

WAIT FOR DEPENDENT 
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AT RETURN/CLOSE 

9. EXCLUSIVE PROCEDURE 

10. REPEAT EVERY 

1 1 . REPEAT AFTER 


RETURN or CLOSE 

entry to busy 
exclusive procedure 

RETURN or CLOSE 

RETURN or CLOSE 


5.2 HAL/S Load Module and Operating Environment 


Object modules output from separate compilations of one or 
more HAL/S-360 programs, zero or more COMSUBS (external HAL/S 
procedures and functions), and zero or more C0MP00LS (external 
data blocks) are linked together in a HALLINK step which 
automatically includes any needed members of the run time 
library# The result is a HAL/S-360 load module which may be run 
4n batch mode as an 05/360 job step. 


The HAL/S-360 load module executes as a single task under 
OS/360 MVT. Within this single OS/ 36 O task, a HAL/S 
multiprocessing environment exists in which programs and tasks 
may be scheduled as dynamic processes that share CPU execution 
based on priority. The HAL/S programmer controls the 
multiprocessing environment via execution of the real time 
statements (SCHEDULE, WAIT, SIGNAL, TERMINATE, CANCEL, etc.). 
These statements in a HAL/S program are compiled as calls to a 
small subset of the routines in the run time library known as 
the real time "executive " which models the process management 
function of the Flight Computer Operating System (FCOS). The 
first HAL program in a load module is scheduled by the 
"executive" as one of its initialization functions, so that a 
single HAL /S program with no real time statements executes as 
if it were merely called in single process system. 


5.3 Processes and the Stack Mechanism 


Since processes may execute independently of each other, a 
mechanism is required which cleanly guarantees non-interference 
in the use of temporary storage for work areas, register save 
areas, call and return linkages, parameter passing, and any 
other process specific information. The stack not only 
satisfies this requirement in a process swapping environment, 
but also results in minimum temporary storage requirements and 
easy implementation of reentrant procedures. 


The stack is a contiguous area of storage defined as a 
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CSECT of sufficient size to handle all temporary storage 
requirements* A stack CSECT is created in the HAL/S load 
module. During execution, the address of the portion of the 
stack in use by the current procedure (called the stack frame) 
is contained in general purpose register 13 ( R 1 3 ) - 


The layout of the initial portion of the stack frame is 
fixed in format and is identical for user procedures and 
functions (internal or external COIISUBS) and run time library 
routines (see Figure 5-3) • The rest of the stack frame depends 
on the temporary storage requirements of the individual 
routine. The total size of the stack frame is specified in the 
procedure prologue. The minimum stack frame size is 80 bytes, 
the size of the fixed portion. 


5,4 Procedures and the Procedure Caller 


In the following discussion, the word procedure applies to 
all run time library routines (excluding intrinsics) as well as 
to all user-written HAL procedures and functions. 


5.4,1 Calling 


When a procedure is called, parameters are loaded and 
control is transferred to the procedure caller ( see 
Figure 5-4). The procedure caller itself is code located 
in the HALSYS CSECT, Its function is to: 

1) increment the stack frame pointer ( R 1 3 ) 

to the end of the current stack frame, thus defining 
thus defining the beginning of the new stack 
frame ; 

2) save the registers of the calling 
procedure in the new stack frame; 

3) initialize certain control words in the 
stack; 

4) branch to the entry address (or prologue) 
of the procedure (see Figure 5-5). 


In the new stack frame, saving of the registers 
establishes the link to the previous stack frame, the 
return address, and any parameters passed in registers R0 
through R4. Parameters passed in floating point registers 
are not saved in the stack automatically. 
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The entry address of the called procedure is copied 
from the 4 bytes following the BALR instruction to the 
stack in order to: 


1) 

align it to a fullword boundry 
loading into R15; 

for 

2) 

save it if the procedure calls 
procedures . 

for any other 


Thus, the base of the calling procedure ( R 1 5 ) need not be 
saved in the new stack frame, allowing the use of R15 in 
updating the stack frame pointer. 


At any time during execution, the stack represents 
the dynamic nesting of the called procedures. It is a 
last-in, first-out stack of stack frames, each frame 
representing a level of dynamic procedure nesting. 

The procedure prologue (see Figure 5-6) is very 
simple, consisting of a single branch instruction that 
skips over some constant data located at fixed offsets 
from the entry point. In the case of alternate entry 
points, two additional instructions set the base to the 
main entry point. 


Figure 5-4 

PROCEDURE AND FUNCTION CALLS 


Load 

R0, 

Argument 

0 

Load 

R 1 , 

Argument 

1 

Load 

R4, 

Argument 

4 

Load 

F0, 

Floating 

Argument 0 

BALR 

R1 4, 

R 1 2 GO 

TO PROCEDURE CALLER 

DC 

i 

Adcon of 

Entry Point 
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PROCEDURE AND FUNCTION EXITS 


B 4(R12) GO TO PROCEDURE EXITER 


Notes : 


a) The -Adcon is a four -byte field aligned on the 
halfword immediately following the BALR instruction. 

b) The one-byte is the lexical level of the called 
procedure or function, as follows: 

Block Type 

0 Programs and tasks, library routines; 

1 COMSUBS, and first level procedures; 

>2 Nested procedures. 

c) The three-byte Adcon is the entry point address of 
the called procedure or function. 


Figure 5-5 


PROCEDURE CALLER 


LH 

R 1 5 , 8 ( R 1 5 ) 

Load current stack frame siz< 

AR 

R 1 5 , K 1 3 

Increment stack frame 
pointer to next stack frame; 

STM 

R0, R 1 4 , 20 ( R 1 5 ) 

Save caller's register in 
new stack frame ; 

LR 

R13, R 1 5 

Set new stack frame ptr. 

SR 

R 1 5 , R 1 5 

Zero error link field 

ST 

R 1 5 , 1 6 ( R 1 3) 


ST 

R 1 5 , 4 ( R 1 3 ) 

Zero statement index and 
and flag field; 

MV C 

0(4, R13), 0 ( R 1 4 ) 

Copy called proc. base 
to stack frame; 

L 

R15, 0 ( R 1 3 ) 

Load called proc . base ; 
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BR 


R15 


GO TO Procedure; 


PROCEDURE EXITER 

LM R2 , H 1 4 , 28 ( R 1 3 ) Restore caller's register 

(including old stack frame 
and return address); 

L R15, 0(R13) Restore caller's base; 

B 4 ( R 1 4 ) Return to caller, 

skipping -Adcon; 

Note: RO and R1 are not restored by the procedure exiter. 


Figure 5-6 


PROCEDURE PROLOGUE 

MAIN 

ENTRY: B «+X(R15) SKIP AROUND CONSTANTS 

DC A(FSIM) ADDRESS OF SIMULATION DATA CSECT 

DC H'stack frame size' FOR PROCEDURE CALLER 

DC AL1(name length, C'name' NAME OF PROCEDURE 

. first 

» 

. instructions 


ALTERNATE ENTRY : same as main entry with additional 

instructions : 

L R 1 5 , =A ( MAIN ENTRY) GET BASE OF CSECT 

ST R15, 0 ( R 1 3 ) UPDATE IN STACK FRAME 


PROCEDURE EPILOGUE 

B 4 ( R 1 2 ) GO TO PROCEDURE EXITER 

Motes : 

1) Main and alternate entries at least full-word aligned. 

2) A(FSIM) is zero for assembled library routines. 

3) High order byte of DC A(FSIM) is used as follows: 
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a) Process event - in Programs and tasks. 

b) Exclusive control event - in Exclusive procedures. 

5.4.2 Exiting 


Procedure exits are simple. A branch instruction 
(Figure 5-4) transfers control to a procedure exiter 
(Figure 5-5). The procedure exiter, like the procedure 
caller, is code located in the HALSYS CSECT. It restores 
registers R2 - R14, leaving RO and R1 for function value 
returns. This sets the stack frame pointer ( R 1 3 ) to the 
caller's stack frame and loads the return address (R14). 
The caller's base ( R 1 5 ) is loaded from his stack frame, 
and a branch is made to the instruction following the 
call, skipping the 4 bytes after the BALR instruction that 
contains the entry address of the called procedure. 


5.5 Intrinsics 

Some of the routines in the run-time library are known as 
intrinsics. Intrinsics have the following characteristics: 

1) calls and returns are done directly, without the use 
of the procedure caller or exiter; 

2) as a result, a new stack frame is not established; 

3) all intinsics are part of the HALSYS CSECT; 

4) as a result, they are always included in the HAL 
load module; 

5) entry addresses of intrinsics are not external symbols, 
but unique displacements from R12, which always points 
to the beginning of the HALSYS CSECT; 

6) intrinsics have special register conventions. 


Figure 5-7 shows an example of a system intrinsic call, Not all 
intrinsics use the parameter registers shown in this example. 
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SYSTEM INTRINSIC CALLS 


LA 

LA 

LA 

LA 

LA 

BAL 

SIDISP = 
intrinsic . 


5.6 User Written Assembly Language Subroutines 

The asssembly language programmer may write programs 
accessible to the HAL programmer. The standard macros 
illustrated in Figures 5-8 through 5-13 should be used to 
ensure compatibility with the HALLINK process and the run-time 
routines . 

Below is a description of the use of these macros. 


R2, result ptr. 

R3, left-hand arg. ptr. 

R4, right-hand arg. ptr. (if needed). 
RO, size 

R1, 2nd size parameter (if needed). 

R 1 4 , SIDISP ( R 1 2 ) 

Unique displacement for each system 
FT1 ,0.50 

Figure 5-7 


5.6.1 HMAIN 

Purpose - to define symbolic registers R0-R10, F0-F4; 

- to set up the first few bytes of control section 
to be compatible with HALLINK . 


Notes: - The label on the HMAIN must begin with an 

#, to enable the HAL compiler to reference the 
program as a COMSUB. 

- Registers R2-R10 may be freely used, because 
procedure caller restores them. 

- User programs should be re-entrant. If any 
temporaries are needed, then the user must 
declare the temporaries in a macro named 
WORKAREA and code MACRO=YES in the operand field 
of the HMAIN macro. 

For example, if the programmer needed three temporaries, 

T1, T2, and T3, he would code: 
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MACRO 

WORKAREA 


T 1 

DS 

F 

T2 

DS 

XLS 

T3 

DS 

D 


MEND 



tfAHYNAME HMAIM MACRO= YES 

5.6.2 HEMTRY 

Purposeito define secondary HAL-accessible entry to assembly 
program. 

5.6.3 HCALL 

Purposeito call another HAL-accessible program. 

Motes: Registers R2-R10 will always be saved; RO, R1, FO, 

F2, F4 are never saved. 

- no form of recursion is permitted. 


5.6.4 HEXIT 

Purposeito return to caller. 

Note: Values may be returned in R1 or FO; if more than 

one value is expected, the compiler will provide an 
area into which the values are to be placed. 

The address of this area is in R1. 


5.6.5 HERRMSG 

Purposeito set up message text in format compatible 
with HERROR macro. 

Notes: A label is required. 

- One operand, the message text, enclosed in quotes 
is required. 
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Example : 


ANYLABEL HERRMSG 'TEXT DESIRED' 


5.6.6 HERROR 

Purpose: Simulate the HAL 'SEND ERROR'. 

Notes: Takes two arguments. First is error number; 

Specified either as a self-defining value in range 
75-100 (the user errors), or as a register number 
specified in parentheses. In the case where the 
register option is chosen, the contents of the 
register must be pre-loaded with a number in the 
range 75-100. The second is the label on the 
HERRMSG macro with the desired text. Again, a register 
may be specified in parentheses. The register 
must contain the address of the label of 
the HERRMSG macro. 


Example : 


FIRST 

HERROR 

80, MSG 

SECOND 

LA 

R6 , 80 


LA 

R8 , MSG 


HERROR 

(R6), (R8) 

MSG 

HERRMSG 

' USER TEXT 
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&L 

11ACR0 

HMAIM 

&MACRO=NO 


STACK 

CURRCODE 

DSECT 

USING 

DS 

STACK, 13 
A . 

CURRENT CODE BASE 


DS 

H . 

H.O. BIT IS EXCLUSIVE FLAG 

STHTNUMB 

DS 

H . 

STATEMENT NUMBER 

AVAILABLE 

DS 

D 

AVAILABLE DOUBLE WORD 

ERRLINK 

DS 

A . 

ON ERROR LINKAGE 

ARGO 

DS 

F . 

CALLER'S ARGUMENTS 

ARG 1 

DS 

F 


ARG2 

DS 

F 


ARG3 

DS 

F 


ARG4 

DS 

F 



DS 

1 OF 

REGS 5-14 


AIF 

( '&MACRO ' EQ 

'NO') .NOMAC 

« 

ADDITIONAL STORGAE 

SPACE REQUIRED FOR THIS ROUTINE 

.11 OH AC 

# 

WORKAREA 
AGO .END 

ANOP 

NO ADDITIONAL STORAGE SPACE REQUIRED 

• END 

STACKEND 

ANOP 

DS 

OD 


STACKLEN 

EQU 

"-STACK 


# 

REGISTER EQUATES 


RO 

EQU 

0 """NOTE"*" 

NOT RESTORED BY HEXIT 

R1 

EQU 

1 """NOTE* * " 

NOT RESTORED BY HEXIT 

R2 

EQU 

2 


R3 

EQU 

3 


R4 

EQU 

4 


R5 

EQU 

5 


R6 

EQU 

6 


R7 

EQU 

7 


R8 

EQU 

8 


R9 

EQU 

9 


RIO 

EQU 

10 


R14 

EQU 

14 


FO 

EQU 

0 


F2 

EQU 

2 


F4 

EQU 

4 


*F6 HAY BE 

: USED 

ONLY IF SAVED 

AND RESTORED 

&L 

CSECT 

USING 

B 

", 15 

*+20 

SKIP AROUND JUNK 


DC 

F'O' . 

ALIGN NEXT TO PROPER BOUNDARY 


DC 

AL2 ( STACKLEN ) STACK SIZE OF THIS ROUTINE 


DC 

AL 1(8), CL8 ' 

&L ' 


HEND 

Figure 

5-8 HHAIN 
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&L 


&L 


L 


MACRO 

HEfJTRY 

Do OF ALIGN ON FULLWORD 

ENTRY &L 
USING &L , 1 5 

B # +20 SKIP AROUND JUNK 

DC F'o' 

DC AL2 ( STACKLEN ) SIZE OF STACK 

DC AL1 ( 8) , CL8'&L' 

15, = A ( &SYSECT ) LOAD BASE OF MAIN ROUTINE 
ST 15, CURRCODE 
USING &SYSECT , 15 
MEND 


Figure 5-9 HENTRY 


MACRO 

&L HACALL &N 

&L BALR 14, 12 CALL VIA PROCEDURE CALLER 

DC VL4 ( &N ) . FOR NO ALIGNMENT 
MEND 


Figure 5-10 HCALL 


MACRO 

&L HEXIT 

&L B 4(0,12) . RETURN 

MEND 


Figure 5-1 1 HEXIT 



MACRO 



&L 

HERRMSG 

&MSG 



AIF 

(T'&L 

EQ 'O' OR T'&MSG EQ 'O') 

&L 

DC 

ALKL 

'ERRM&SYSNDX ) 


ERRM&SYSNDX DC C&MSG 
HEXIT 

.ERROR HNOTE 8, 'MACRO IGNORED. NO LABEL OR MESSAGE TEXT 
MEND 


Figure 5-12 HERRMSG 
5-19 
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MACRO 


&LAB 

HERROR 

&IJUM , &MSG 


LCLB 

&NEEDMVI 


LCLC 

&M, &N,&L 


AIF 

(N'&SYSLIST EQ 2). OK 


HNOTE 

2, 'MISSING OR EXTRA OPERANDS' 


HEXIT 


.OK ANOP 



&L 

SETC 

'SLAB' 

&H 

SETC 

' &MSG ' 

&N 

SETC 

' &NUM ' 


AIF 

( ' &MSG '(1,1) HE '(') .TESTNUI1 


CHOP 

0,4 

&L 

ST 

&MSG ( 1 ) ,*+12 

&L 

SETC 


&M 

SETC 

'0' 

& NEEDMVI 

SETB 

1 

.TESTNUM 

AIF 

( ' &MUM ' ( 1 , 1 ) HE TESTMVI 

&L 

STC 

&NUM( 1 ) ,*+6 

&L 

SETC 


&N 

SETC 

'O' 


AGO 

.BAL 

, TESTMVI 

AIF 

(MOT &NEEDMVI ) . BAL 


MV I 

*+8,&NUM 

.BAL 

AH OP 


&L 

BAL 

1 4 , 24 ( , 1 2 ) LINK TO ERROR HANDLER 


DC 

AL1 (&N) , AL3 ( &N) 


MEND 



Figure 

5-13 HERROR 
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6. HAL/S Characterics Specific To The 360 


6 . 1 Introduction 

The HAL/S language as available on the IBM/360 has 
several implementation dependencies. These dependencies 
arise due to the specific hardware and software facilities 
available on the machine. The following subsections 
enumerate these characteristics. 

6.2 Compile Time Characteristics 

6.2.1 Character Set 

The character set specified in the HAL/S 
Specification document is available in its entirety 
on the 360. The HAL/S-360 compiler will therefore 
recognize this full character set. The internal 
coding scheme for the characters is EBCDIC. No 
other coding scheme is recognized. 


6.2.2 Internal Table Capacities 

a) The maximum number of symbol table entries is 
1000. The symbol table is filled with the 
names of user-defined variables and labels as 
the input source is scanned. 

b) A maximum of 32767 literals may be used in a 
single compilation. 

c) The maximum number of characters permitted in 
the sum of all character literals in one 
compilation is 3000. 

d) Storage for replace text is limited to 1000 
characters. However, multiple blanks within 
such text are stored in a compressed form. 

6.2.3 Data Type Size Limitations 

a) Arrays are limited to 3 dimensions. 

b) Each dimension in an array is limited to the 
range 1 to 32767. 

c) The maximum row or column dimension of a matrix 
is 64 . 
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d) The maximum dimension of a vector is 64, 

e) Character strings are limited to 255 characters. 

f) Bit strings may not be over 32 bits long. 

g) Single precision integers are 16-bit signed 

quantities . 

h) Double precision integers are 32-bit signed 

quantities . 

i) Single precision scalar values are represented 
internally in the standard 360 floating point 
format using 32 bits (1 sign, 7 exponent, 24 
mantissa ) ♦ 

j) Double precision scalar values are represented 
internally in the standard 360 double precision 
format using 64 bits (1 sign, 7 exponent, 56 
mantissa) . 

k) Individual characters within character strings 
are represented internally as the b-bit EBCDIC 
pattern for the character. Hence, the result of 
converting a single character to a bit string 
by means of the BIT conversion function is an 
8-bit string corresponding to the EBCDIC bit 
pattern for the character. 

6.2.4 Program Organization Limits 

a) The number of external names allowed in any one 
compilation is 100. An external name is 
defined as any user-defined or built-in 
function which causes an external reference to 
be satisfied by the link editor. 

b) Function invocation (whether built-in or 
user-defined) may not be nested more than 10 
levels deep. 

c) DO groups nay not be nested to a depth exceeding 

15 levels. 

d) The total number of elements in initial lists in 

any one compilation is limited to 32767. 

6.2.5 Input/Output Statements 

a) Device numbers in input or output statements are 
limited to the range 0-9. 

. ' 95 < 
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6.2.6 Program Naming Convention 


Each successful HAL/S compilation produces at 
least one named control section (CSECT) and one or 
more unnamed control sections (PCs). The CSECT name 
is derived according to the following rules: 


a) HAL/S compilation unit names are transferred to 
the emitted object code by using only the first 
seven characters of the HAL/S name. The name 
will be padded or truncated to seven characters 
where necessary. In the case of a CSECT 
corresponding to a TASK, the name is truncated 
to five characters. Care should be exercised in 
naming to insure that only unique names will be 
generated for a given compilation. 


b) Any occurrence of the underscore character (_) 

' in the first 7 characters of a PROGRAM, 

PROCEDURE, FUNCTION, TASK, or COMPOOL is 
eliminated. The resulting characters are joined 
together to produce the characteristic name of 
the compilation unit (e.g. A_B_C becomes ABC). 

An additional character is placed on the front 
of the resultant name to form the final name 
for each of the individual situations in which 
the name is used. These additional names for 
internal control sections are: 

$ - the executable code control 
section name for a PROGRAM 

# - the executable code control 
section name for a COtlPOOL or 
comsub, a nested FUNCTION, or a 
nested PROCEDURE. 

@ “ the control section used by a 
PROGRAM or TASK for a temporary 
work area 

$nn - assigned to TASKs within a 
PROGRAM but using only the first 
five characters of the 

characteris tic name, where nn is 
a two digit number assigned 
uniquely to each TASK in a single 
compilation unit, "nn" is 01 for 
the first TASK defined within a 
compilation; 02 for the second; 
etc. Note that the name of a 
CSECT corresponding to a TASK is 
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derived from the PROGRAM in which 
it is defined, not from the label 
of the TASK declaration itself. 


c) A separate CSECT called FIRSTPGM is generated 
for each compilation which is a PROGRAM. Its 
contents in 360 Assembler language are as 
follows ( the name of the HAL program in this 
example is HALPROG) : 

FIRSTPGM CESECT 

EXTRN HALSTART 
DC V ( HALPROG) 

END HALSTART 


This establishes the link between the HAL set 
up routines and the HAL program. 


In addition to control section names, the 
characteristic name of a compilation unit may 
appear in certain external contexts preceded by the 
following characters: 

@ “ the member name of the template 
created for a compilation unit 

# “ the member name of the simulation 
data file created for a 
compilation unit 

Each PROCEDURE or FUNCTION declared internal to the 
main compilation unit results in a Private Control 
Section (PC) containing the executable code. 

d) Each compilation unit has associated with it a 
PC containing all the literals used in the 
program, as well as address constants needed by 
the program. If the compilation unit is a 
PROGRAM, there is an address constant referring 
to the stack associated with the PROGRAM. All 
TASKS also have stacks associated with them, 
and their address constants are also in this 
PC. The name of the stack associated with a 
PROGRAM or TASK is obtained by replacing 

the $ in the CSECT name with an @ . 

f) All STATIC variables declared within a 

compilation unit are allocated space in a 
separate PC. If no variables are defined within 
a compilation unit, a PC of zero bytes may or 
may not be generated depending upon the 

implementation. AUTOMATIC variables defined in 
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CODE 


FSIM 


DATA 



present only for PROGRAMS. In addition, a separate 
stack exists for each TASK. 

Figure 6-1 
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A typical example 


( P ARM . HAL = 1 TRACE* specified) 
ABC: PROGRAM; 

X! TASK? ...CLOSE? 

Y: PROCEDURE; ...CLOSE? 

Z : UPDATE BLOCK ? ... CLOSE ? 

CLOSE ABC; 


CODE FSIM DATA 



Figure *>~2 S8 < 

INTERMETRICS INCORPORATED • 701 CONCORD AVENUE • CAMBRIDGE, MASSACHUSETTS 02138 * (617) 661-1840 




STACK LAYOUT 


Procedure Temps 
& Reentrant Locals 


R14 

return address 

R13 

(previous stack 

R12 

frame) 

Rll 


RIO 


R9 


R8 


R7 


R6 


R5 


R4. 

arg4 

R3 

arg3 

R2 

arg2 

R1 

„ argl 

R0 

argO 

Error Link 

Doubleword 

Temporary 

t flag 

statement 1 

(field number j 

ll 

Current Code Base 


increasing 
nerrn r y 
address 


NOTE: High order bit of flag field is "1" if exclusive procedure; 

other 15 bits "0" (reserved). 
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REENTRANT PROCEDURES are allocated in the 
stack, not In this PC. 


Refer to Figure 6-1 and 6-2 for examples of typical 
layouts of generated object decks. 


Figure 6-3 indicates the logical relationships 
between the CSECTs and PCs generated for the 
following PROGRAM. An arrow (A— ►B) indicates 
reference in A to B: 


6.2.7 The INCLUDE Compiler Directive 

Use of the INCLUDE compiler directive to 
access a symbolic library has been implemented in 
the following way. The name found on the INCLUDE 
directive such as: 

D INCLUDE COMPOOLA 

will be used to search the symbolic library. The 
name must be a 1 to 8 character string. 

The symbolic library must be defined by the 
following JCL: 

//HAL . INCLUDE DD DSN=<library name > , <other parameters> 

The <library name) must be the data set name of the 
^ library. The library data set must have partitioned 
^ organization and must be referred to in the JCL by 
J data set name only ( DSN=HAL . LIB) , not as data set 
and member name ( DSN=HAL . LIB( COMPOOLA) ) . 

The library thus defined is searched for a 
member whose name is exactly the name found on the 
INCLUDE directive. The library must contain card 
images of the same size as the primary input, but 
may be blocked in any legal manner. Two or more 
libraries may be concatenated in the JCL if they 
conform to the standard JCL rules for for such 
concatenation . 

If an INCLUDE request cannot be satisfied by 
referencing the INCLUDE DD card, an attempt will be 
made to find the member by using the 0UTPUT6 DD 
card. This search technique allows multiple- 
compilation jobs to reference template libraries 
created automatically in earlier steps without the 
need to indicate an INCLUDE DD card. 

1G0< 
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6.2.8 ACCESS Rights Implementation 


The HAL/S language allows managerial 
restrictions to be placed upon the usage of 
user-defined variables and external routines. The 
existence of such a restriction is indicated by the 
use of the ACCESS attribute as described in the 
HAL/S Language Specification. The manner in which 
the restricitons are enforced in the HAL/S-360 
compiler system is described below. 

Any variable in a COMPOOL template or any 
external routine to which the ACCESS attribute has 
been applied is considered to be restricted for the 
compilation unit which is being compiled. The 
restriction is slightly different for variables 
than for blocks: 

a) Variables with the ACCESS attribute may not have 

their values changed. 

b) Block names may not be used at all. 

These restrictions may be selectively overridden 
for individual variable and block names. The 
selection of which ACCESS controlled names are to 
be available to the unit being compiled is 
performed by processing an external dataset. The 
external dataset is known as the Program Access 
File (PAF). The PAF must have partitioned 
organizaiton and is specified by the following JCL: 

//HAL. ACCESS DD DSII = <PAF name>, <other parameters> 

where the <PAF name> is the dataset name of the PAF 
without any member specification. Note that a PAF 
need not be defined if the access control 
facilities of the HAL/S compiler are not being 
used. 

Each member of the PAF contains the 
information about ACCESS controlled names which are 
to be available to one unit of compilation. The 
member name is defined by a Program Identification 
Name (PIH). The PIN is specified to the HAL/S-360 
compiler by using the PROGRAM compiler directive in 
the primary input stream: 

D PROGRAM ID = <id > 
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The <id> field of the directive is a 1 to 8 
character identifying name which is used to select 
the member of the PAF to be processed for the 
current compilation's ACCESS information. The 
appearance of the PROGRAM directive in the 
compiler's input stream causes immediate processing 
of the PAF member specified. Therefore, the 
PROGRAM directive must follow any COKPOOL or COMSUB 
templates which may specify ACCESS-controlled data. 
Also, the PROGRAM directive must appear before the 
definition of the block which is the primary unit 
of compilation. In general, the input stream seen 
by the compiler should look like the following: 
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<COMPOOL or COMSUB template> 


9 

<COMPOOL or COMSUB template> 
D PROGRAM ID=<id> 

M PROG NAME: PROGRAM; 


The format of an individual PAF member is described 
below. 

a) Column 1 of each record is ignored except when 
column 1 contains the character M C", in which 
case the entire record is ignored. 

b) The portion of each record which is processed is 

the same portion which is processed in the 
primary compiler input (SYSIN). 

c) COMPOOL elements which are to be made available 
to the compilation are specified as: 

<COMPOOL-name>( <var-name>, <var-name> , ... <var-name>) 
or 

< COM POOL- name > ( $ALL) 

The first format specifies access to individual 
variables within the named COMPOOL. The second 
format specifies access to all variables within 
the named COMPOOL. 

d) Access to external block names is specified as: 

$BLOCK ( < ext -name > , <ext-name>, ... <ext-name>) 

e) Blanks are allowed anywhere in the record except 

that names may not be broken by a blank. 

f) Either of the constructions (c) or (d) above may 

span more than one record. 

g) The name of the particular COMPOOL in the form 
(c) above may appear more than once; i.e. the 
variables in a particular COMPOOL do not have 
to be specified at one time. Similarly, the 
form $ BLOCK may appear more than once. 

Some validity checking is performed by the compiler 
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while processing the PAF member. Warnings are 
issued for the following conditions: 

1) A syntax error on a PAF record - the bad record 
is printed; 


2) Names mentioned in the PAF are not defined; 


3) 

Elements of $BL0CK 

names ; 

in the PAF are not 

block 

4) 

Requests for names 
protected ; 

which are 

not 

ACCESS 

5) 

Variables found, but 
specified; 6) Names 

not within 
used in the 

the COMPOOL 
context of a 


COMPOOL-name which are not COUPOOLs. 

7) Elements of an ACCESS-protected COMPOOL block * 
are mentioned in the PAF before the COMPOOL 
block itself is freed for use. 

If, at the time the PROGRAM directive is 
encountered, there have been no ACCESS-controlled 
variables declared, the PAF is not opened. If a 
user does not require access to any, the PROGRAM 
directive and associated PAF members may be 
omitted . 


6,2.9 Template Generation 

If a HAL/S compilation contains invocations of 
external PROGRAMS, procedures, functions 
( "COMSUBS” ) or references to variables in an 
external COMPOOL, the block templates for those 
external blocks must appear in the compilation (see 
Section 2,4), The HAL/S-360 compiler features 
automatic generation of block templates during the 
compilation of these blocks. Compilations which 
later require use of such templates can retrieve 
them by means of the INCLUDE compiler directive. 

The INCLUDE directive causes any desired HAL/S 
source text to be taken from a specified member of 
a PDS rather than from the regular input stream. 

It is recommended that block templates be 
maintained on a different dataset from that used 
for other kinds of INCLUDE text. If block 
templates are maintained on a PDS called <templib> 
and other material on a PDS caller <otherlib>, then 
the appropriate JCL for such a compilation is: 

//HAL , INCLUDE DD DSN=< templib> ,....( other parameters) 

// DD DSN = <otherlib> , ... (other parameters) 
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For the compilation of any compool, or external 
procedure or function block, the following JCL must 
be specified: 

//HAL . INCLUDE DD DSN=< templib> ,....( other parameters) 
// DD D5U=<otherlib> ,....( other parameters) 

//HAL . 0UTPUT6 DD DSN=<templib> , (other parameters) 

During compilation, the following events take 
place : 

The HAL/S compiler ascertains whether or not a 
block template for the block already exists in 
the dataset referenced by the INCLUDE DD cards. 

The search algorithm is applied in the same way 
as for the INCLUDE compiler directives (see 
6,2.7) * 


If no such template exists, then it is added as 
a new member of <templib>. The compiler emits 
the following message in the output listing: 

####* TEMPLATE LIBRARY MEMBER <membername> NOT FOUND - ADDED 


If the template already exists, and the new 
template is different from the old, the member 
of <templib> is replaced and the compiler emits 
the message: 

***** TEMP LATE LIBRARY MEMBER <membername> FOUND AND CHANGED 


If the new template is the same as the old, 
then replacement does not take place and the 
compiler emits the message: 

*****TEMPLATE LIBRARY MEMBER <membername> FOUND - CHANGE 

MOT REQUIRED 


Any error discovered during Phase I of the 
compilation will inhibit the adding or 
replacement of the member of <templib>, and the 
compiler emits the message: 


***** COMPILATION ERRORS INHIBITED TEMPLATE GENERATION 


Each template has attached to it a version number 
between 01 and 255. On first generation, the 
version number assigned is 01. Every time the 
template is updated in <templib>, the version 
number is incremented by 1 . If the version number 
exceeds 255, it is reset to 01, and thereafter 
begins incrementing again. 
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The format of a template as maintained in the 
template library is exactly as described in the 
Language Specification. It is followed by a 
VERSION directive card specifying its version 
number : 

Example : 

INC: PROCEDURE; 

CLOSE; 

D VERSION @ 

@ Is a generally unreadable character 
whose hexadecimal value is the version 
number . 

The <membername> of a block template is formed by 
taking the characteristic name of the compilation 
unit (see Section 6.2.6) and prefixing it with the 
character . 

Note that this naming convention determines 
the form of the INCLUDE directive which can be used 
to retrieve the block template; e.g. compilation 
unit A_B_C produced a block template as member ABC 
which must be specified as ABC on an INCLUDE 
directive in order to find the proper template. 


ioe< 
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7. HAL/S-360 Input/Output Operations 


7. 1 HAL/S-360 FILE I/O 

This section presents a detailed description of the 
FILE I/O implementation for HAL/S-360 release 7. The 
implementation is consistent with the current Language 
Specification* It allows for three different types of 
files, giving the user the freedom to chose the type most 
appropriate for the application. The types cover a range 
of characteristics, from the most efficient but least 
flexible (Type I) to the least efficient but most flexible 
(Type III). If the user does not chose a type, the default 
is Type III. 

Familiarity with the Language Specification for FILE 
I/O is assumed. 


7.2 File Type Characteristics 


A FILE I/O statement results in an unformatted core 
image transfer between a contiguous data area in memory 
and a physical block in a direct access data set, 
hereafter referred to as a file. Blocks may be read, 
written, or updated in any desired order. The OS/ 36 O BDAM 
(Basic Direct Access Method) routines are used. The 
distinguishing characteristics of each type of file are 
described in the following paragraphs. The descriptions 
use the following concepts: 


Block length: The number of bytes in the block. Both the 

input and output file expressions make a request for 
a block transfer of a specific number of bytes, 
determined by the size of the variable or expression 
on the opposite side of the assignment (=) operator. 
This size must be consistent with (and in some cases 
automatically determines) the block length attribute 
of the file (see Sec, 7 . 3 . 4 ). The maximum size block 
possible is 32,760 bytes 


B : 


Block identification number 
supplied by the user in the 


(an integral value) 
file expression FILE 
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(F,B). (F is the file number). 


Bmax : The number of blocks or dummy blocks in a Type I or 

II file, fixed at initialization time and determined 
by the block length and the number of tracks 
allocated to the file. 


Track t An OS/36O Direct Access Storage Device (DASD) 
concept. It is the smallest unit of DASD space 
allocation. Track capacity varies with different 
device types. The track capacity of a 2314 disk, for 
example, is 7294 bytes. 


7.2.1 Type I: Dense Fixed-length Blocks 

Block leiUE-tii Every block is the same length. 


Block identification: B is the sequentially relative 

block number in the data set and directly determines 
•the location of the block in the file. 


V.alid range of _B.;. 0<=B<=Bmax- 1 . If the file contains 200 

blocks, then 0<=B<=199. Bmax<=2**24- 1 (16, 777, 215). 


Block existence: All blocks in the valid range exist in 

an initialized file, whether or not an output file 
statement merely updates the identified block. An 
input file statement reading a block not written by 
an output file statement assigns binary zeroes to the 
variable (this may not be appropriate for some 

applications, or for certain data types - see Sec. 
7.5) 


Block access time: Block access time is less (faster) 

than for Types II or III. 


S_pace utilization: Space for a block in the valid range 

is guaranteed, since the blocks already exist. DASD 
space utilization is good only if most values of B in 
the valid range are used for real blocks, DASD space 
utilization will be poor if the range of values used 
for B is sparse. 


1G8< 
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7.2.2 Type II: Sparse Fixed-length Blocks with Keys 


Block length: Every block is the same length. 


Block identification: B is the hardware key of the block 

The location and sequence of blocks is not directly a 
function of B, so that a search for the block using B 
as the key must be made each time it is accessed. 


Valid range of B: B is translated to EBCDIC numeric 

characters for the key, so that the valid range of B 
is 0<=B<=10 **n-1, where n=number of characters in 
the key (see KEYLEN in the DCB parameters 7.3.4). If 
KEYLEN=6, then 0< = B< = 99999999 . Since B is 
communicated as an integer, the upper limit is 
2**31— 1 (2, 147, 483» 647) for double precision, or 

2**1 5— 1 (32, 767) for single precision. 


Block existence: A block exists only if it has been 

written. Available space in an initialized file 
consists of dummy blocks ( high-order byte of key is 
X'FF'). The initial number of dummy blocks (Bmax) 
limits only the total number of real blocks, not the 
maximum value for B. Dummy blocks are overwritten 
with real blocks (with key=B) when a block is written 
for the first time. Existing blocks are updated in 
place when a block is re-written. An attempt to input 
a dummy block will result in a run-time error. 


Block access time : Block access time is slower than Type 

I because of the hardware search for the block by the 
key B. The time taken depends on the DCB LIMCT 
parameter and other factors (see Sec. 7.3.4 and 
Appendix J). Writing a block for the first time takes 
at least twice as long as an update of an existing 
block because it occurs only after a search for a 
non-existent block fails. 


Space utilization: An attempt is made to spread the 

blocks evenly throughout the file. A run-time error 
of ”no space in file” occurs when available space on 
a track or sequence of tracks is exhausted. This may 
occur even though there is available space elsewhere 
in the file, unless OPTCD=E is specified. See 
Appendix J for a description of the block location 
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and search algorithms for sparse files ( Types XI and 
III), DASD space utilization is good if the values 
of B are uniformly sparse. 


7.2.3 Type III: Sparse Dif fering-length Blocks with Keys 


Block length: Blocks may have different lengths. The same 

block may not be re-written with a different length, 
except in the case indicated below. 


Block identification: Same as for Type II. 


Valid range of B: Same as for Type II. 


Block existence: A block exists only if it has been 

written. Available space in an initialized file is 
recorded in capacity records, one per track. A new 
block is written in the available space of a track, 
and the capacity record for that track is updated to 
reflect the reduction in available space. When a 
block is re-written, the old block is updated in 
place if the new block has the same length; otherwise 
a length error occurs. If 0PTCD=F was specified, and 
the standard fixup (ON ERROR SYSTEH or IGNORE) is 
taken, then the old block is deleted and a new block 
with the new length is written in available space. 
The old block and the space it occupies remain 
unavailable. An attempt to input an unwritten block 
will result in a run-time error. 


Block 

access time: 

Same 

as for 

Type 

II. 

Space 

utilization : 

Same 

as for 

Type 

II. 


7.3 Selecting a File Type 
7.3*1 Choosing a File Type 


A number of factors should be taken into 
consideration when choosing a file type. The primary 
factor is whether or not blocks in the same file need to 
be of different lengths. If so, then Type III is the only 
choice (barring user control over the "block length" error 
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- see Sec. 7.4), since different length blocks are not 
possible in file Types I and II. 

Another factor is the range of values for B. If it is 
known that the maximum value of B will be less than or 
equal to the number of possible blocks in the file ( 
determined only by the size of the file), and that most 
values of B in that range will be used as a real block 
identification, then Type I i3 the best choice (most 
efficient). On the other hand, if the range of values of B 
is sparse (for example, B=100, 200, 300. .etc), then Type 
II or III should be used. 

Another factor may be that in a Type I file any block 
in the valid range exists; that is, it may be input 
without ever having been output. If the occurence of the 
"block not found" error is needed for proper processing in 
a certain application, then a Type I file cannot be used, 
unless the program can test for and recognize a block of 
binary zeroes as an invalid block. 


lli< 
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7.3.2 Specifying a File Type 


The type of a particular file is determined only by 
its DCB parameters. DCB parameters may be specified by the 
user on the DD card for a new file, or they are supplied 
automatically by the operating system from the dataset 
label (DSCB) of an existing file. 

A file must be initialized for a particular type 
before it can be used. Initialization causes the file to 
be filled with available space of the proper format and 
destroys any data existing previously in the file. The 
initialization may be performed in a single job or job 
step from the HAL program execution, or it may be 
automatically initialized by HAL before its first use. 
Automatic initialization is performed only if a file is 
created and used in the same job step ( i.e. if the DD 
card specifies DISP=HLW). In any case, the DCB parameters 
supplied at initialization time on the DD card determine 
the file type. Defaults for omitted DCB parameters are 
indicated below. If no DCB parameters are supplied, the 
defaults cause initialization of a Type III file, the most 
flexible but least efficient. 


7.3.3 DCB Parameters by File Type 

These DCB parameters are the ones that determine the 
file type. 


7 . 3 . 3 . 1 Type I 

RECFI1=F or FT 
and 

KEYLEIJrO or omitted 

7. 3. 3. 2 Type II 

RECFflsF or FT 
and 

KEYLEN>0 

7. 3. 3. 3 Type III 

RECFI1 = V , VS, or U 
and 

KEYLENM) 

DEFAULT: RECFM=U , KEYLEN=8 
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7.3*^ Summary by DCB Parameter 

Options and defaults specific to a file type are so 
indicated . 


BLKSI ZE = number : This specifies the block length for Type 

I or II, or the maximum block length for Type III. It 
must be less than or equal to the track capacity of 
the DASD device unless RECFM=FT or VS is specified, 
in which case the the maximum is 32, 760. If RECFfl = V 
or VS, the BLKSIZE should be 4 more than the largest 
block length. 

DEFAULT: Types I and II: length of first block transfer; 

Type III: maximum blocksize of the device. 


DS0RG=DA : This identifies the dataset organization of the 

file as direct access. Although it is not required 
for HAL FILE I/O, it should be specified if the file 
is to become permanent and be manipulated by OS 
utilities. The OS utility program IEHH0VE requires 
this identification to successfully copy a file. 


KEYLEN =number : This specifies the number of characters in 

the key for file types II and III. It must be in the 
range 1-16. If KEYLEN=1, note that only 10 blocks may 
exist in the file no matter how big it is, since it 
would limit the the range of keys to 0-9. When B is 
converted to a key, it must fit in a field of n 
decimal digits, where KEYL£N=n, or an error occurs. 

DEFAULT: KEYLEU = 3 (Type III only). 


LinCTsnumber : This specifies the number of tracks (or 

blocks, if OPTCD=R) to be searched in a Type II or 
III file when attempting to read or update an 
existing block. It is also used when searching for 
available space for writing a new block. This 

parameter is ignored unless the extended search 
option is used (0PTCD=E), See Appendix J for block 
location and search algorithms. 

DEFAULT: LIMCT=number of tracks (or blocks) in the file 

(i.e. the entire file is searched). 

MOTE: This parameter is not a ’’remembered” attribute of 

the file. It must be re-specified (or altered) each time 
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the file is used. 


OPTCD=K, F | R , ER , or EF : This parameter specifies various 

options . 


OPTCDsE : extended search (Types II and II) This specifies 

tKe extended search option. See Appendix J. 


OPTCD=F : feedback (Type III only) This option causes the 

standard fixup for the "block length mismatch” error 
in a Type III file to rewrite the block with its new 
length. Its absence prevents changing the length of 
an existing block. 


OPTCD=R : relative block addressing (Types I and II only) 

This option is required and is defaulted to for a 
Type I file. In a Type II file, it causes a 
different record location and search algorithm to be 
used . 

DEFAULT: OPTCD=R (Type I only) 


RECFH=F,FT : Type I or II; =U,V,VS: Type III only. This 

specifies the block (record) format. RECFM=VS 
(variable spanned) must be specified if the maximum 
block length (BLKSIZE) is greater than the track 
capacity in a Type III file. RECFM=FT (fixed with 
track overflow) should be specified for the same case 
in a Type I or II file, and also when the ratio of 
block length to track capacity is such that there 
would be a serious w aste of DASD space. (Without 
track overflow only integral numbers of whole blocks 
are placed on a track.) Track overflow allows a fixed 
block to be broken up across a track boundary, 
resulting in maximum utilization of track space. 
RECFMsFT can be specified only if the hardware track 
overflow option exists for the device. 

DEFAULT: RECFfl = U 


7.*! Run Time Errors 


The following errors may occur at run-time when 
executing a FILE I/O statement. 

ERROR 31 - SYNAD ERROR: message 

1 ± 4 < 
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An uncorreetable I/O error occurred, described by 
"message". An uninitialized file may be the cause. The 
"message” is generated by the system macro SYNADAF, 

SYSTEM action: limited fixups. 

ERROR 32 - MISSING DD CARD - FILEn 

FILE I/O was attempted without a defining DD card. 
SYSTEM action: terminate. 

Standard fixup : The I/O operation is ignored. NOTE: 

Errors 31 and 32 may also occur in sequential I/O. 

ERROR 64: NO SPACE IN FILE 

An attempt was made to add a new block to a Type II 
or III file, but available space was exhausted. To correct 
this error, re-run the job with a new larger file, or with 
the existing file and OPTCD=E. 

SYSTEM action: terminate. 

Standard fixup: The output FILE statement is ignored. 


ERROR 65 - BLOCK LENGTH MISMATCH 

The block in the file and the block in memory have 
different lengths. The occurence of this error depends on 
the file type and whether input or output is requested. An 
input file statement will never read more data than 
requested. Even if the block in the file is larger than 
the variable being filled. 

SYSTEM action: unlimited errors. 

Standard fixup: For input, the number of bytes read is 
the minimum of the two lengths. For output, the block in 
the file is truncated or padded with binary zeroes to 
force it to the proper length. If the error occurs for an 
existing block in a Type III file and OPTCD=F is 
specified, the standard fixup will rewrite the block with 
a new length, deleting the old block. 


Type I and II: 

The error may occur on input, output, and update. 
Type III, RECFM=U: 

The error may only occur when updating an existing 
block. 

Type III, RECFM=V or VS: 

The error may occur on input or output. 


ERROR 66 
The 
negative 
10*»n-1 , 

Standard 


- BLOCK NUMBER OUT OF RANGE 
block number supplied is invalid, 
or greater than the limit (Bmax-1 
KEYLEN=n for Type II and III). 

SYSTEM action: terminate, 

fixup: The I/O is ignored. 


It is either 
for Type I; 
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ERROR 70 to 79 - BLOCK bbbbbbbbbb HOT FOUND 

Analogous to sequential I/O end of file errors 40 to 
49, this error occurs in a Type II or III file when the 
specified block number is legal but the block does not 
exist. Errors 70 to 79 correspond to files 0 to 9 
respectively . 


7.5 HAL Data Type Considerations 


The user should be aware of the implications of using FILE I/O 
with different data types, A block in a file is a binary core 
image and contains no type information. No problem exists if a 
block is written from and read into data of the same type and 
length. 

If a block is written from one data type and read into 
another, no error indication is given, assuming that the 
lengths are the same. However, subsequent use of the data may 
, cause errors ranging from the mild to the severe. The following 
lists by data type the kind of trouble that could be caused by 
reading in a block with arbitrary binary information. 


Bit strings: none 
Integers : none 

Scalars, Vectors, and Matrices: Underflow errors may 
occur due to unno.rmalized floating point numbers. 

Character strings: DECLAREd maximum length may be 
altered. The first two bytes are the maximum and actual 
lengths respectively. If the maximum length is increased 
in this manner, subsequent assignment into the character 
variable could destroy the data following it. 

Name variables: Although explicit use of name variables 
is disallowed in FILE I/O statements, they may be input 
and output if imbedded in a structure. Since name 
variables contain machine addresses, unpredictable results 
may occur, including ABENDS. The same holds true, even 
when strict type matching is observed, if a block is 
written in one job or job step and read in another. 


7.6 OS/360 Considerations 


7.6,1 DD Cards 
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One DD card is needed to define each file referred to 
in a HAL program. For example, when file 3 is used, i.e. 
when the expression FILE( 3 , <arith exp>) appears in a HAL 
program, the minimum DD card required is: 

//FILE3 DD UNIT=oYSDA , SPACE = ( TRK , number ) 

where "number” defines the size of the file in tracks. 
This results in a temporary Type III file which gets 
deleted at the end of the job step. 

The general format of the DD card for a temporary 
file is: 

//FILEn DD UNIT=unit , VOL=volume , SPACE=space , DCB= ( list of 
DCB parameters) 

where n is the file number (0-9). The "unit", "volume", 
and "space" values may be determined from a JCL manual. 
The DCB parameters are covered in section 7.3»^* 

If a permanent file is desired, the DSN and DISP 
parameters must also be specified. If the file is being 
created, then DISP = ( NEW , KEEP ) or DISP = ( NEW , CATLG) is 
needed. If an existing file is used, then DISP=0LD or 
DISP=SHR is needed. 


7.6.2 Separate Initialization of a File 

Although HAL will automatically initialize a new 
file, circumstances may require separate initialization. 
The routine in the run-time library that does the 
automatic initialization may be invoked as an independent 
utility program. The following JCL illustrates the use of 
this utility: 

// INIT EXEC PGH=FORMATDA,PARMsanydd 
//STEPLIB DD DSN = HALS . RUNLIB , DISPrSHR 
//anydd DD ... appropriate parameters 

If it is desired to re-initialize an existing file, then 
PARH = anydd must be changed to PARH = ' #anydd ' . 


Return Codes 

0: successful initialization 

4: not formatted - DISP=OLD 

8: missind DD card specified in parm field 

16: no parm field specified 
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7.7 Execution Time Characteristics 
7.7.1 Input/Output 

a) The I/O device defined to be the error message channel 
(CHAHNEL6 is the default) is forced to have record format FA 
or FBA. 

b) Numeric formatting of output items is done as follows: 

integers - an 11-character field is 

printed with the number right 
justified. A floating minus sign 
is added if the number is negative, 

single 

precision 

scalars - a 14-character field is printed 
as follows: 


sx.xxxxxxxE+txx 

where s is a blank or minus sign; 

x is a single digit 0 to 9; 
t is a plus or minus sign; 


double 

precision 

scalars - a 23-character field is generated 

as follows: 


sx .xxxxxxxxxxxxxxxxEtxx 


c) If not specified through JCL, the HAL/S I/O 

routines will assume a logical record length of 
80 for unpaged output devices and a logical 
record length of 133 for paged output devices. 
The first character of the 133 character paged 
output record is assumed to be an ASA carriage 
control character. 
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7.8 User-Defined Execution Time JCL 


The user may require additional exectuion time JCL to service 
his program's requirements: 

Additional HAL/3 data sets (other than the CHANNELS and 
CHANNEL6 supplied in the procedure). These are data sets 
with names CHANNELn where n is in the range 0 to 9* These 
data sets are referenced by HAL/S I/O statements 
specifying the proper n as their device number (e.g. 
URITE(8) references DD card CHANNELS). 

The HAL/S I/O routines make some assumptions about the 
characteristics of the data sets which are allocated to 
the various CHANNELn DD cards. These assumptions, along 
with a description of devices and organizations supported 
by HAL/S are detailed below. 

The user may supply any, all, or none of the DCB 
attributes for CHANNELn DD cards. The record formats 

which are acceptable to HAL/S are: 

F FB FA FBA FBSA 

V VB VA VBA 

U UA 

Machine carriage control is acceptable but subject to 
interpretation described below. 


7.8.1 General Rules Used by HAL/S to Create DCB Attributes 


a. BLKSIZE not supplied (by JCL or data set). 

The maximum block size of the particular device is found. 
The BLKSIZE is set to the largest multiple of LRECL which 
Is less than or equal to this block si2e. Note that for 
tapes this maximum size is 32767 bytes which would require 
a sizeable buffer area to be taken out of main storage. 


b. LRECL not supplied. For PRINT files the LRECL 

defaults to 133. For non-PRINT files the default is 80. 


c. RECFM not supplied. For PRINT files the RECFM 
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defaults to FBA. For non-PRINT files the default is FB 


7.8.2 General Rules Governing HAL/S Sequential Output 

a. If the mode is PRINT and the DCBRECFM specifies 

"A”, carriage control characters will be automatically 
generated. For M M W on PAGED devices, it is the user's 
responsibility to see that the first character of each 
output line has the proper control characters. For UNPAGED 
devices, control characters are not allowed. 


b. Variable length record specification will cause 

records to be written in variable format. However, the 
records will actually be all the same length (LRECL). 


c» Format U records (undefined rocord format) 

will be written in the proper form, but all records will 
be the same length (LRECL). 


7.8.3 General Rules Governing HAL/S Sequential Input 

t 


a. Carriage control characters encountered during 

input will be available to the programmer; i.e. scanning 
of the input will begin at the carriage control character. 

b. Variable length records may be read. 

The 4 byte descriptor field of each record will not be 
available to the programmer. The effective length of a 
variable record will be "length read minus i| M (subject to 
further modification due to carriage control). 
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APPENDIX A 


Compile-Time JCL Options 

The following is a list of options which may be coded in 
the "OPTION=" field of the JCL invoking the HAL/S compiler. 


Type 1 options are ones which are specified by the 
occurrence of a keyword in the PARM field. The keyword may be 
preceded by the letters "NO" to indicate that the option is not 
in effect. The default value assumed by the compiler if a 
keyword is not specified is listed first. 

Type 2 options are ones which have "values" associated 
with them. The default values are shown- 


Type 1 Options 

N0LISTING2/ - Causes unformatted 

LISTING2 source listing to be generated 

NODUMP/DUMP - Requests the compiler to produce a memory 

dump if certain internal compiler errors 
occur 


NOLIST/LIST - Produces an assembly listing from Phase II 

of the compiler 

TRACE/NOTRACE - Causes the generation of a link to the HSS 

end-of- statement routine in the object 
module. Enables Real Time execution and 
.debugging. 


NODECK/DECK - Controls production of an additional 

object deck on the 0UTPUT4 DD card 

NOTABLST/ - Causes Phase III of the compiler to 

TABLST produce formatted dump to the simulation 

data file {SDF ) . 

NOSRN/SRN - Causes the compiler to omit the last 

eight columns or characters from the 
source scanning. These columns are then 
used to print information on the 
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TABLES/ 

NOTABLES 


Controls generation of 
Simulation Data Files 


NOADDRS/ - Indicates the presence of 

ADDRS statement address information 

in the Simulation Data Files 


Type 2 Options 


PAGES=25Q - Sets the maximum page number to be 

allowed in generation of the primary 
compilation listing 


LINECT=59 - Sets the maximum number of lines 

which will be printed on any one page of 
either the primary or secondary source 
listing 


TITLE- ... - Specifies 1 to 60 characters used 

by the compiler when printing header 
information at the top of each page of 
the listing. 


In addition to those options described above/ certain 
others exist to support operation of the SDL. These options 
include: 


Type I Options 


NOSDL/SDL - Informs the compiler that it is 

operating within the SDL. Certain 
actions are then taken# actions dif- 
ferent from those taken during Stand- 
Alone operation. An example of such 
action is inclusion of extra information 
in the primary source listing to allow 
tracing of source updates- 
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APPENDIX B 


Execution-Time JCL Options 


The following is a list of options which may be coded in 
the ,, RUNPARM= M field of the JCL invoking the HAL/S compiler* 
This information is directed to the "FARM" field of the 
execution step. 


TAB=n 


Specifies the automatic spacing between elements 
on output. The default value is 5. 


LINES=n 


Specifies the number of lines per page of paged 
output. The default value is 55 lines. 


MCHAN=n • Specifies the channel number (DD card CHANNELn) on 

which error and trace messages appear. The valid 
range is 0-9; CHANNEL6 is the default. 


TRACE=0 

TRACE=1 

TRACE=2 
TRACE-3 
TRACE =4 


Specifies no tracing (default option). 

Statement tracing; 

(Note that this option is valid only if 'TRACE' 
was specified on the compilation). 

Procedure & function call and return tracing. 

Statement, procedure & function call, and return tracii 

Executive tracing {combined with other trace options 
by addition). 


DUMP=0 


No HAL/S variables dumped. 


DUMP=1 


HAL/S variables dumped on ABEND (default option). 
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DUMP=2 : 

MSGLEVEL=0 : 

MSGLEVEL=1 : 

ERRORLIM=n : 

SIMTIME=n : 

SPEED=n ' : 

PCBS^n : 

FIRSTPGM= : 

<name> 

PROFILE : 
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same as DUMP=1 but also on normal end? 

(Note that DD cards HALSYMB and HALDUMP are requited), 
no backtrace on normal termination? 

(This is the default value). 

backtrace occurs on normal termination. 

specifies the maximum number of execution time 
errors allowed . The default value is 10. The 
maximum is 254; if 255 is specified# the SYSTEM 
action will be UNLIMITED. 


number specifying the starting time in 

seconds of the RUNTIME simulation clock (DEFAULT: SIMTJME 


number specifying the number of machine 

cycles per second to be used in simulated execution 

time ( DEFAULT :SPEED=500#000.0) • 


whole number specifying the maximum number of 
programs and tasks in the run (DEFAULT: PCBS=10 ) . 

full <name> (underscores included? 
up to 32 characters) of the PROGRAM which is 
to receive control first in the execution 
of the HAL/S Load Module. 


Requests that an execution profile of the 
executed program be printed. 


±^ 4 < 

B-2 

701 CONCORD AVENUE * CAMBRIDGE, MASSACHUSETTS 02138 • (617) 661-1840 



APPENDIX C. 


Prototype Catalogued Procedures 

This Appendix contains seven examples of the form of 
catalogued procedures needed to compile, link edit and execute 
a HAL/S program. The seven procedures perform varying degrees 
of processing. The procedure names and their uses are: 

HALSC - Compile a HAL/S program; 

HALSCL - Compile and link a HAL/S program? 

HALSCLG - Compile and link a HAL/S program, and execute 
it in direct mode; 

HALSCLD - Compile and link a HAL/S program, and execute 

it under control of the execution monitoring system? 

HALSL - Link a previously compiled HAL program? 

HALSLG - Link and execute a previously compiled HAL/S program? 

HALSLD - Link a previously compiled HAL/S program, and execute 
it under control of the monitoring system. 

The most complex procedure, HALSCLG, is described line by line. 


The following comments apply to the prototype catalogued 
procedure HALSCLG listed in this appendix. The comments 
generally apply equally to any of the other procedures. 


Line 10000 - This PROC statement names the procedure and 

defines the symbolic parameters. The 
OPTION and RUNPARM parameters are the means 
of supplying optional information to the 
compiler and run-time system respectively. 


Lines 10100 - The name of the compilation step is HAL, 
10200 The name of the actual program to be 

executed is MONITOR. MONITOR handles all 
compiler/OS interfaces and also performs 
the actual loading and overlaying of the 
two phases of the compiler. The compiler 
requires a 350K region, although a larger 
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Line 10300 - 


Line 10400 - 


Line 10500 - 


Line 10600 - 
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region may be specified. The compiler will 
always use all the memory it is given. A 
larger region will generally result in 
smaller compilation times. A default time 
limit of 1 minute is supplied. This is 
sufficient for most average size HAL/S 
programs (approx. 300 HAL /S statements). 

The PARM field contains the compile-time 
options. The OPTION field receives any 
user-specified options. 


The STEPLIB DD card specifies the location 
of the load module library containing the 
module MONITOR needed to run the compiler. 
This card may define any direct access 
library which contains the proper module or 
may be deleted at installations where the 
module has been made part of the system 
library ( SYS 1 . LINKLIB) . 


The PROGRAM DD card defines the phases of 
the compiler that is to be used. 

This data set has a DCB of the form: 

DCB=(RECFM=F # LRECL =720 0,BLKSIZE =7200) 

and may reside on direct access or magnetic 
tape. It is recommended, however, that 
direct access be used. 


The SYSPRINT DD card defines the primary 
listing data set. This is generally 

assigned to a system output class, but may 
be associated with any sequential data set 
with the proper characteristics. The 
record format must be FA or FBA with a 
logical record length of 133 and any 
appropriate block size. If not supplied in 
the JCL, the DCB will default to 

DCB=( RECFM=FBA , LRECL= 1 33 , BLKSIZE=7 182) 


The LISTING2 DD card defines the secondary 
listing data set. It may define a system 
output class or any sequential data set. 
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The DCB requirements are the same as for 
SYSPRINT. 


Lines 10700 - 
10900 


Line 1 1 000 - 


Lines 11100 * 
11200 
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The 0UTPUT3 DD card defines the data set 
which is to receive object code which is 
produced by the compiler. In the prototype 
procedure, this data set is given a 
temporary Name (&&HAL0BJ) and is passed 
(DISP=010D, PASS) ) to subsequent steps. 

Since this data set contains card images, 
it must have a logical record length of 80 
and a record format of F or FB. The 

blocking factor may be any legal multiple 
of 80. If no DCB information is supplied 
in the JCL, the default will be 

DCB=(RECFM=FB,LRECL=80, BLKSIZE=7200 ) . This 
DD card may specify a direct access, 
magnetic tape, or unit record device. 


The OUTPUTS DD card defines the location 
to which a duplicate of the OUTPUT3 file 
will be sent under control of the "DECK" 
compiler option. Its DCB characteristics 
are identical to OUTPUT3, 


The OUTPUTS DD card defines the data set 
which will receive the Simulation Data 
File (SDF). This file allows the 

execution-time DUMP and TRACE facilities to 
associate memory locations with HAL/S 
variable names. For the compile-load-go 
type of run this data set is generally a 
temporary one which exists only for the 
duration of the job. However, if the 
results of a given compilation are saved to 
be executed many times without 

recompilation, the SDF should be saved as 
well . 

The OUTPUTS DD card must define a 
partitioned data set. The SPACE parameters 
used in the prototype procedure are more 
than adequate to contain the mapping file 
of any one HAL/S program. 

The 0UTPUT5 DD card is accessed during the 
code generation phase of the compilation. 

One member of the partitioned data set is 
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Line 1 1300 - 
11400 


Line 11500 - 


Lines 1 1600 - 
11600 


created for a compilation unit. The name 
of the member is the first 8 characters of 
the name of the program or procedure being 
compiled, padded with blanks if necessary. 

If a member with the desired name does not 
exist at compile-time, one is created. If 
a member with the desired name already 
exists, it is replaced by the new member. 

The use of a permanent partitioned data set 
makes it possible to maintain a "library" 
of mapping files, with the member names 
uniquely specifying the HAL/S compilations 
to which the maps may be applied. 

The format of the file must have a logical 
record length of 1680 and a record format 
of F. This DCB information must be 
supplied in the JCL. 


The 0UTPUT6 DD card defines the partitioned 
data set onto which templates for compilation 
units may be placed. Refer to 6.2.7 for details 
of template generation. The DCB attributes 
for the data set should be compatible 
with those used for primary 
compiler input (SYSIN) and secondary 
compiler input (INCLUDE). 


The ERROR DD defines the partitioned 
data set which contains the error message 
texts used by the syntax analysis phase of 
HAL/3., This data set is supplied with the 
compiler and, being a partitioned data set, 
must reside on a direct access volume. 


The FILE1 through FILE6 DD cards specify 
work files. These files are used for 
interphase communication. Thd device may 
be either direct access or magnetic tape. 
Space equivalent to approximately 60 tracks 
on a 2314 should be available for each DD 
card. The DCB is internally specified and 
should not be altered by a JCL. 
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Lines 20C00 - 

2 nor 


Lines 3000 - 
3700 
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The SYSUDUMP CD card specifies the location 
to which an abend dump is to be sent in the 
event that the compiler terminates 
abnormally. 

These lines define the data sets necessary 
to allow the external references in the 
obiect proqram to be resolved and prepare 
the proqram for loading into memory. The 
JCL is the standard required by the OS/36Q 
Linkaqe editor plus that which is necessary 
for execution of the HALLINK processing 
proqram , Details of the use of individual 
CD cards may be found in the IBM 

linkaqe-Lditor and Loader manual. The only 
feature of this JCL which is peculiar to a 
HAL/S compilation is the form of the SYSLIB 
PC card and the addition of the STACKOBJ 
and TIM PLOAD DD cards. These two 

additional DT cards should be used as 
specified in the procedures. They serve as 
intermediate work data sets for the HALLINK 
proqram. 

The SYSPHINT dd card should always 
have a BLKSI7.2 parameter specified in the 
JCL. 

The HAL/S runtime library packaqe must 
be the primary source of modules to resolve 
external references. Any references which 
cannot be resolved from the HAL/S library 
will be resolved from any libraries 

catenated to the first DD card. 

If the user has any HAL/S proqram 
references to user-written non-HAL/S 

subprograms or to previously compiled HAL/S 
proqrams, it is at this point that the 
proqrams must be supplied to the linkinq 
process. This may be done through the use 
of a catenated DD card specifying a user 
library, or by direct user input of control 
cards to the link editor. 


These cards specify the execution of 
the load module created in the LKED 
step. The JCL for the step differs 
depending upon the choice of either 
direct execution or execution under 
the execution monitoring system. The 
two modes are determined by the par- 
ticular procedure invoked: HALSCLG 
and HALSCLD invoke the execution 
monitoring system. 

The EXEC card either invokes the load 
module produced in the LKED step directly, 
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or it invokes the execution monitor 
(EON MON) * 

Certain JCI cards are common to both modes of execution: 

The CHANNFL6 DD card is supplied in the 
procedure because device 6 is commonly used 
as an output unit* It is also supplied 
because all system-qenera ted output (e.g. 
runtime error raessaqes) is directed by 
default to CHANNE16. The user may alter the 
destination of such messages via the MCHAN 
optional parameter* 

The CHANNELS DD card has been supplied in 
the procedure because it is common practice 
to assume that device 5 will be used for 
input. The use of the DPNAME parameter on 
the CHANNELS DD card allows the user to 
specify either: 


//GO. CHANNELS DD parameters 

//GO.SYSIN DD parameters 
to define the runtime input. 

The SYSPUMP TD card specifies the location 
to which a hexadecimal memory dump will be 
sent in the event of an abnormal 
termination. 

The following JCL is special to the execution monitoring 
system : 


The STrPLIB PD card indicates the location 
of the EUNMON proqram. 

The PFOGEAM PD card indicates the location 
of the diagnostic processing proqram which 
is executed by RUNMON. 

The SYSPRINT DD card identifies the output 
of the diagnostic processing program. 

Peouest cards and request card errors are 
listed here. 

The HAT SDF DD card defines the dataset 

containing the SDF for the program (s) being 
executed. In the case of the prototype 
procedure, this is the temporary dataset 
created by the compilation step as 0UTPFJT5. 

The HALLIR DD card defines the dataset 
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containing the HAL/S load module to be' 
executed. The prototype procedure indicates 
the module produced in the LKED step lust 
preceedinq the execution step. 
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HAL SC 


10000 //HAL SC 
10100 //HAL 
10200 // 

10300 //STEPLIB 
10400 //PROGRAM 
10500 //SYSPRINT 
10600 //LISTING2 
10700 //0UTPUT3 
10800 // 

10900 // 

11000 //OUTPUT4 
1 1100 //OUTPUTS 
1 1200 // 

11300 //OUTPUT6 
1 1400 // 

1 1500 //ERROR 
11600 //FILE1 
117(30 //FILE2 
1 1800 //FILE3 
1 1900 //FILES 
12000 //FILE6 
12100 //SYSUDUMP 


PROC OPTIONr 

EXEC PGM =MONITOR,REGION=350K, TIME* 1 , 

PARMs'&OPTION' 

DD DISP=SHR,DSN=HALS360. MONITOR 

DD DISP=SHR t DSN =HALS360. COMPILER 

DD SYSOUT=A,DCB=(RECFM=FBA,LRECL=133,BLKSIZEs3458) 

DD SYSOUT=A , DCB=(RECFM=FBA,LRECL=133 , BLKSIZE=3458 ) 

DD UNITsSYSDA , DISP= (MOD , PASS) , SPACE= ( CYL , ( 1 , 1 ) ) , 

■ DCBs ( RECFMsFB , LRECLs80 ,BLKSIZE=400) , 

DSN=&&HALOBJ 

DD S YSOUTsB , DCBs ( RECFMsFB , LR EC Ls80 , BLKSIZE=400 ) 

DD DISPs (MOD , PASS) , DSN=&&HALSDF , SPACE =(TRK, (2,2,1)) , 
DCB=(RECFM=F, LRECL= 1680, BLKSIZEs 1680) , UNIT=SYSDA 
DD DISPs (MOD, PASS) , DSN=&&TEMPLIB , SPACE =(TRK ,(2,2,1)), 
DCB= ( RECFMsFB, LRECL=80,BLKSIZE= 1680) ,UNIT=SYSDA 
DD DISP=SHR,DSN=HALS360.ERR0RLIB 
DD UNITsSYSDA , SPACE = ( CYL , 3) 

DD UNITsSYSDA , SPACEs ( CYL , 3 ) 

DD UNITsSYSDA , SPACE =( CYL , 3) 

DD UNITsSYSDA , SPACEs (CYL , 3) 

DD UNITsSYSDA, SPACEs(CYL, 3) 

DD SYSOUTsA 
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HALSCL 


10000 //HALSCL 
10100 //HAL 
10200 // 

10300 //STEPLIB 
10400 //PROGRAM 
10500 //SYSPRINT 
10600 //LISTING2 
10700 //OUTPUT3 
10800 // 

10900 // 

1 1000 //OUTPUT4 
1 1100 //OUTPUTS 
1 1200 // 

1 1300 //OUTPUT6 
11400 // 

1 1500 //ERROR 
11600 //FILE1 
1 1700 //FILE2 
11800 //FILE3 
11900 //FILES 
12000 //FILE6 
12100 //SYSUDUMP 
20000 //LKED 
20100 // 

20200 //STEPLIB 
20300 //SYSPRINT 
20400 //SYSLIB 
20500 //SYSLIN 
20600 // 

20700 //SYSLMOD 
20800 // 

20900 //SYSUT1 
21000 //STACKOBJ 


PROC OPTIONr 

EXEC PGM=MONITOR , REGION = 3 50K , TIME si t 
PARM= ' &OPTION # 

DD DISP=SHR,DSN=HALS360. MONITOR 
DD DISP=SHR,DSN=HALS360. COMPILER 

DD SYSOUT=A t DCB = (RECFM = FBA,LRECL = 133,BLKSIZE = 3458) 

DD SYSOUT=A, DCB=(RECFM=FBA, LRECL=133»BLKSIZE=3458) 

DD UNIT=SYSDA,DISP=( MOD, PASS) ,SPACE=( CYL , ( 1 , 1) ) , 

DC B=(RECFM=FB,LR EC L=80, BLKSIZE = 400 ) , 

DSN=&&HALOBJ 

DD SYSOUT=B, DCB=(RECFM=FB,LRECL=80 , BLKSIZE =400) 

DD DISP= (MOD , PASS) , DSN=&&HALSDF , SPACE =(TRK ,(2,2,1)) , 
DCB=(RECFM=F ,LRECL= 1680, BLKSIZE =1680) ,UNIT=SYSDA 
DD DISP= (MOD, PASS) , DSN=&&TEMPLIB , SPACE = (TRK , (2 , 2 , 1 ) ) , 
DCB = (RECFM=FB, LRECL = 80 , BLKSIZE = 1680) , UNIT = SYSDA 

DD DISP=SHR,DSN=HALS36Q.ERRORLIB 

DD UNIT=SYSDA , SPACE=( CYL , 3 ) 

DD UNITsSYSDA , SPACE =( CYL , 3) 

DD UNIT=SYSDA , SPACE=(CYL , 3) 

DD UNIT=SYSDA,SPACE=(CYL,3) 

DD UNIT=SYSDA,SPACE=(CYL,3) 

DD SYSOUT=A 

EXEC PGM=HALLINK, REGION =100K, PARM=( LIST, MAP) , 

COND= ( 0 , LT , HAL ) 

DD DISP=SHR,DSN=HALS360. MONITOR 
DD SYS0UT=A,DCB=BLKSIZE=1210 
DD DSN=HALS360.RUNLIB, DISP=SHR 
DD DISP=OLD,DSN=&&HALOBJ 
DD DDNAME=SYSIN 

DD DSN=&&HALMQD(GO) ,DISP=( ,PASS) ,UNIT=SYSDA, 
SPACE=(CYL, (1,1,1)) 

DD SPACE= ( CYL , ( 1,1)) , UNIT= (SYSDA , SEP = (SYSLIN , SYSLMOD ) ) 
DD SPACE=(TRK,(5,10)),UNIT=SYSDA 


- gjjOO //TEMPLOAD DD 


SPACE= ( C YL , ( 1,1,1)) , UNIT=SYSDA 
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HALSCLD 


10000 
10100 
10200 
10300 
10400 
10500 
1 0600 
1 0700 
1 0800 
10900 
11000 
1 1100 
1 1200 
1 1300 
1 1400 
1 1500 
11600 
1 1700 
1 1800 
1 1900 
1 20'00 
12100 
20000 
20100 
20200 
20300 
20400 
20500 
20600 
20700 
20800 
20900 
21000 
21100 
30000 
30100 
30110 
30200 
30300 
30400 
30500 
30600 
30700 
30800 
30900 


//HALSCLD 

//HAL 

// 

//STEPLIB 

//PROGRAM 

//SYSPRINT 

//LISTING2 

//OUTPUT3 

// 

// 

//OUTPUT4 

//OUTPUTS 

// 

//OUTPUT6 

// 

//ERROR 
//FILE 1 
//FILE2 
//FILE3 
//FILES 
//FILE6 
//SYSUDUMP 
//LKED 
// 

//STEPLIB 

//SYSPRINT 

//SYSLIB 

//SYSLIN 

// 

//SYSLMOD 

// 

//SYSUT1 
//STACKOB J 
//TEMPLOAD 
//GO 
// 

// 

//STEPLIB 

//PROGRAM 

//SYSPRINT 

//HALLIB 

//CHANNEL6 

//HALSDF 

//CHANNELS 

//SYSUDUMP 


PROC OPTION= , RUNPARM= 

EXEC PGMsMONITOR , REGION =3 50K , TIMEs 1 , 

PARMs ' &OPTION ' 

DD' DISP=SHR,DSN=HALS360. MONITOR 

DD DISP=SHR , DSN=HALS360 . COMPILER 

DD SYSOUTsA, DCB=(RECFM=FBA, LRECL si 33 , BLKSIZE = 3 458) 

DD SYSOUT =A , DCB= ( RECFM=FBA , LRECL= 1 33 , BLKSIZE = 3458 ) 

DD UNIT=SYSDA,DISP= (MOD, PASS) , SPACEs ( CYL ,(1,1)), 

DCB= ( RECFMsFB , LRECLs80,BLKSIZE=400) , 

DSN=&&HALOBJ 

DD SYSOUT =B , DCB = ( RECFM=FB , LRECL=80 , BLKSIZE =400 ) 

DD DISPs (MOD, PASS) , DSN=&&HALSDF , SPACEs ( TRK ,(2,2, 1)) , 
DCB = ( RECFM=F , LRECL= 1 680 f BLKSIZE = 1 680) ,UNIT=SYSDA 
DD DISPs (MOD, PASS) , DSN=&&TEMPLIB , SPACEs (TRK , (2 , 2 , 1 ) ) , 
DCB= ( RECFMsFB, LRECL =80, BLKSIZE = 1 680 ) ,UNIT = SYSDA 
DD DISP=SHR,DSN=HALS360.ERR0RLIB 
DD UNIT=SYSDA,SPACE=(CYL,3) 

DD UNIT=SYSDA,SPACE=(CYL,3) 

DD UNIT=SYSDA,SPACE=(CYL , 3) 

DD UNIT=SYSDA , SPACE = ( CYL , 3 ) 

DD UNIT=SYSDA , SPACE= ( CYL , 3 ) 

DD SYSOUT=A 

EXEC PGM =H ALLINK , REGI0N= 1 00K , PARM= (LIST, MAP ) , 

COND=( 0 , LT, HAL ) 

DD DISP=SHR,DSN=HALS360.MONITOR 
DD SYSOUT=A , DCB=BLKSIZE= 1210 
DD DSN=HALS360.RUNLIB,DISP=SHR 
DD DISP=OLD,DSN=&&HALOBJ 
DD DDNAME=SYSIN 

DD DSN = <3:&HALMOD , DISP= ( , PASS ) , UNIT = SYSDA 
SPACE=(CYL, (1,1,1)) 

DD SPACE= (CYL, (1,1)) , UNIT= ( SYSDA , SEP= ( SYSLIN , SYSLMOD ) ) 
DD SPACE=(TRK,(5,10)),UNIT=SYSDA 
DD SPACE =( CYL, ( 1,1,1)) ,UNIT=SYSDA 
EXEC PGMsRUNMON , REGION s 1 00K , 

CONDs ( (0 , LT , HAL ) , ( 4 , LT , LKED ) ) , 

PARM= '&RUNPARM ' 

DD DISP=SHR,DSN=HALS360. MONITOR 
DD DISP=SHR,DSN=HALS360. DIAGPROC 

DD SYSOUTsA , DCB= ( RECFM=FBA , LRECL= 1 33 , BLKSIZE =3458 ) 

DD DISP=OLD, DSN=&&HALMOD 
DD SYSOUTsA 

DD DISP=OLD , DSN=&&HALSDF 
DD DDNAMEsSYSIN 
DD SYSOUTsA 
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HALSCLG 


10000 //HALSCLG 
10100 //HAL 
10200 // 

10300 //STEPLIB 
10400 //PROGRAM 
10500 //SYSPRINT 
10600 //LISTING2 
10700 //OUTPUT3 
10800 // 

10900 // 

11000 //OUTPUT4 
1 1100 //OUTPUTS 
1 1200 // 

1 1300 //0UTPUT6 
1 1400 // 

1 1500 //ERROR 
11600 //FILE1 
11700 //FILE2 
11800 //FILE3 
11900 //FILES 
12000 //FILE6 
12100 //SYSUDUMP 
20000 //LKED 
20100 // 

20200 //STEPLIB 
20300 //SYSPRINT 
20400 //SYSLIB 
20500 //SYSLIN 
20600 // 

20700 //SYSLMOD 
20800 // 

20900 //SYSUT1 
21000 //STACKOBJ 
21100 //TEMPLOAD 
30000 //GO 
30100 // 

30200 // 

30300 //CHANNEL6 
30600 //CHANNEL5 
30700 //SYSUDUMP 


PROC OPTION=, RUNPARM= 

EXEC PGM=MONITOR , REGION = 3 50K , TIME = 1 , 

PARM: 'NOTABLES , &OPTION ' 

DD DISP=SHR,DSN=HALS360. MONITOR 
DD DISP=SHR,DSN=HALS360.COMPILER 

DD SYSOUT=A,DCB=(RECFM=FBA,LRECL=133,BLKSIZE=3458) 

DD SYSOUT=A,DCB=(RECFM=FBA,LRECL=133 ,BLKSIZE=3^58) 

DD UNIT=SYSDA,DISP= (MOD, PASS) , SPACE: (CYL, (1,1)), 
DCB=(RECFM=FB,LRECL=80,BLKSIZE=400) , 

DSN=&&HALOBJ 

DD S YSOUT=B , DCB:( RECFM:FB , LRECL=80 , BLKSIZE=400 ) 

DD DISP= (MOD, PASS ) ,DSN=&&HALSDF , SPACE: (TRK, (2,2, 1 ) ) , 
DCBs(RECFM=F, LRECL= 1680, BLKSIZEs 1680) ,UNIT=SYSDA 
DD DISP: (MOD, PASS) , DSN:&&TEMPLIB ,SPACE=(TRK, (2,2, 1) ) , 
DCB = ( RECFM = FB , LRECL = 80 , BLKSIZE = 1680) ,UNIT=SYSDA 
DD DISP=SHR,DSN=HALS360.ERRORLIB 
DD UNIT=SYSDA , SPACE = ( CYL , 3 ) 

DD UNIT=SYSDA , SPACE: ( CYL , 3 ) 

DD UNIT = SYSDA , SPACE-: ( CYL , 3 ) 

DD UNIT:SYSDA , SPACE: (CYL , 3) 

DD UNIT=SYSDA , SPACE: ( CYL , 3) 

DD SYSOUT:A 

EXEC PGM:HALLINK , REGION: 100K , PARM: ( LIST , MAP ) , 

COND: ( 0 , LT , HAL ) 

DD DISP=SHR,DSN=HALS360.MONITOR 
DD SYSOUT:A,DCB:BLKSIZE=1210 
DD. DSN:HALS360.RUNLIB,DISP = SHR 
DD DISP=OLD,DSN:&&HALOBJ 
DD DDNAME=SYSIN 

DD DSN:&&HALMOD(GO) , DISP = ( , PASS ) ,UNIT:SYSDA, 

SPACE:( CYL ,(1,1,1)) 

DD SPACE: (CYL, (1 ,1)) , UNIT: ( SYSDA , SEP : (SYSLIN , SYSLMOD) ) 
DD SPACE=(TRK,(5,10)) ,UNIT:SYSDA 
DD SPACE: ( C YL, ( 1,1,1) ) ,UNIT:SYSDA 
EXEC PGM:* . LKED. SYSLMOD, REGION: 100K, 

COND: ( (0 , LT , HAL ) , ( 4 , LT , LKED) ) , 

PARM: '&RUNPARM ' 

DD SYSOUT:A 
DD DDNAME:SYSIN 
DD SYSOUT:A 
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halsl 


10000 //HALSL PROC 

20000 //LKED EXEC PGM=HALLINK , REGI0N= 1 00K , PARM= (LIST f MAP ) 

20100 //STEPLIB DD DISP=SHR f DSN=HALS360 . MONITOR 
20200 //SYSPRINT DD SYSOUT=A f DCB=BLKSIZE=1 21 0 
20300 //SYSLIB DD DSN=HALS360 . RUNLIB , DISP=SHR 
20400 //SYSLIN DD DDNAME=SYSIN 

20500 //SYSLMOD DD DSN = &&HALMOD(GO) , DISP = ( , PASS ) , UNIT = SYSDA t 
20600 // SPACE = CCYL, (1 , 1 , 1 }) 

20700 //SYSUT1 DD SPACE = ( CYL t (1,1)),UNIT=( SYSDA , SEP=( SYSLIN , SYSLMOD) ) 
20800 //STACKOB J DD SPACE=(TRK,(5,10))» UN IT = SYSDA 
20900 //TEMPLOAD DD SPACE=( CYL , ( 1 ,1 ♦ 1 ) ) , UNIT=SYSDA 
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HALSLD 


10000 

20000 

20100 

20200 

20300 

20400 

20500 

20600 

20700 

20800 

20900 

30000 

30100 

30150 

30200 

30300 

30400 

30500 

30600 

30800 

30900 


//HALSLD 

//LKED 

//STEPLIB 

//SYSPRINT 

//SYSLIB 

//SYSLIN 

//SYSLMOD 

// 

//SYSUT1 
//STACKOB J 
//TEMPLOAD 
//GO 
// 

// 

//STEPLIB 

//PROGRAM 

//SYSPRINT 

//HALLIB 

//CHANNEL6 

//CHANNELS 

//SYSUDUMP 


PROC RUNPARM= 

EXEC PGM =HALLINK,REGION=100K,PARM=( LIST, MAP) 

DD DISPsSHR , DSN=HALS360 . MONITOR 
DD SYS0UT=A,DCB=BLKSIZE=1210 
DD DSN=HALS360.RUNLIB,DISP=SHR 
DD DDNAME=SYSIN 

DD DSN=&&HALMOD, DISP=( .PASS) ,UNIT=SYSDA, 

SPACE=(CYL, (1,1.1)) 

DD SPACE=(CYL, ( 1 .1)) , UNIT= (SYSDA , SEP =( SYSLIN , SYSLMOD ) ) 
DD SPACE = (TRK , (5, 10)) ,UNIT=SYSDA 
DD SPACEzCCYL , ( 1 . 1 . 1 ) ) . UNIT=SYSDA 
EXEC PGMrRUNMON. . REGION = 100K, 

COND=(4 , LT , LKED) , 

PARM= ' &RUNPARM ' 

DD DISP=SHR.DSN=HALS360. MONITOR 
DD DISP=SHR f DSN=HALS360. DIAGPROC 

DD SYSOUT=A.DCB=(RECFM=FBA.LRECL=133,BLKSIZE=3458) 

DD DISP=OLD,DSN=&&HALMOD 
DD SYSOUTzA 
DD DDNAME=SYSIN 
DD SYSOUT=A 
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HALS LG 


10000 //HALSLG PROC RUNPARM= 

20000 //LKED EXEC PGM=HALLINK , REGION* 1 00K , PARM= ( LIST , MAP ) 

20100 //STEPLIB DD DISP=SHR , DSN=HALS360 . MONITOR 
20200 //SYSPRINT DD SYSOUT=A , DCB=BLKSIZE= 1 2 1 0 
20300 //SYSLIB DD DSN =HALS360 . RUNLIB, DISP=SHR 

20400 //SYSLIN DD DDNAME=S YSIN 

20500 //SYSLMOD DD DSN=&&HALMOD(GQ) , DISP= ( , PASS ) , UNIT=SYSDA , 

20600 // SPACE =( CYL, (1,1,1)) 

20700 //SYSUT1 DD SPACE=( CYL , ( 1 , 1 )}, UNIT* ( SYSDA , SEP = (SYSLIN , SYSLMOD ) ) 
20800 //STACKOB J DD SPACE=(TRK , (5 , 10) ) , UNIT=SYSDA 
20900 //TEMPLOAD DD SPACE* ( CYL, (1,1,1)), UNXT=SYSDA 
30000 //GO EXEC PGM =*. LKED . SYSLMOD , REGION* 1 OOK , 

30100-// - --- CCND-( 4 * LT , LKED 1 

70200 // PARM* '&RUNPARM ' 

30300 //CHANNEL6 DD SYSOUT=A 
30600 //CHANNEL5 DD DDNAME=SYSIN 
30700 //SYSUDtIMP DD SYSOUT=A 
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APPENDIX D 


Ccmnile Time Error Messages 

A complete lis* of compile time error messages is 
presented here. The first table gives the mnemonic naming 
scheme used to identify the c lass- suhc la ss structure of the 
Phase I error messages. The complete list of Phase I errors 
are presented next. Phase IT errors are listed last. These 
errors do not have a mnemonic naming scheme and are simply 
listed with their severities. The occurrences of double 
question marks (??) in the text of the messages listed here 
indicate positions at which text specific to each actual error 
will ho inserted {e.g. a variable name may be inserted to make 
a clear identification of the error source) . 
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Irror ciutlfUitioia 


Note; "b” denotes a blank. 


CLASS A: ASSIGNMENT STATEMENTS 

A ARRAY ASSIGNMENT 

V COMPLEX VARIABLE ASSIGNMENT 

b MISCELLANEOUS ASSIGNMENT 


CLASS B: ■ COMPILER TERMINATION 

A UAL MAT BLOCK SIZE 

N NAME SCOPE NESTING 

S STACK SIZE LIMITATIONS 

T TABLE SIZE LIMITATIONS 

X COMPILER ERRORS 

b MISCELLANEOUS 


CLASS C: COMPARISONS 

b GENERAL COMPARISONS 


CLASS D: DECLARATION ERRORS 

ATTRIBUTE LIST 
STORAGE CLASS ATTRIBUTE 
DIMENSION 

FUNCTION DECLARATION 
INITIALIZATION 

L OCKING ATTRIBUTE _ 

•TRUCTUW TMFLXTI TREE ORGANIZATION 
FlCTOREj)/TJW FACTO RED SPECIFICATION 
TYPE SPECIFICATION 
UNDECLARED DATA 
MISCELLANEOUS 


140 < 

D-2 

INTERMETRICS INCORPORATED * 701 CONCORD AVENUE • CAMBRIDGE, MASSACHUSETTS 02138 • (617) 661-1840 


A 

C 

D 

F 

I 

L 



S 

T 

0 

b 



T 


TYPE SPECIFICATION 


0 


UNDECLARED DATA 


b 


MISCELLANEOUS 


CLASS 

E: 

EXPRESSIONS 


A 


ARRAYNESS 


B 


BIT STRING EXPRESSIONS 


C 


CROSS PRODUCT 


D 


DOT PRODUCT 


L 


LIST EXPRESSIONS 

I 

n 


MATRIX EXPRESSIONS 


0 


OUTER PRODUCT 


V 


VECTOR EXPRESSIONS 


b 


MISCELLANEOUS EXPRESSIONS 


CLASS 

F: 

FORMAL PARAMETERS S ARGUMENTS 


D 


DIMENSION AGREEMENT 


N 


NUMBER OF ARGUMENTS 


S 


SUBBIT ARGUMENTS 


T 


TYPE AGREEMENT 


CLASS 

G: 

STATEMENT GROUPINGS (DO GROUPS) 


B 


BIT TYPE CONTROL EXPRESSION 


C 


CONTROL EXPRESSION 


E 


EXIT/REPEAT STATEMENTS 


L 


END LABEL 


V 


CONTROL VARIABLE 

- 

CLASS 

I: 

IDENTIFIERS 


L 


LENGTH 


R 


REPLACED IDENTIFIERS 


S 


QUALIFIED STRUCTURE NAMES 


CLASS 

L: 

LITERALS 


B 


BIT STRING 


C 


CONVERSION TO INTERNAL FORMS 


F 


FORMAT OF ARITHMETIC LITERALS 


S 


CHARACTER STRING 



CLASS H: 

MULTILINE 

FORMAT 

C 

OVERPUNCH CONTEXT 

E 

E-LINE 
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0 

s 

b 


OVERPUNCH USE 

S-LINE 

COMMENTS 


CLASS P: PROGRAM CONTROL S INTERNAL CONSISTANCE 


A ACCESS CONTROL 

C COMPOOL BLOCKS 

D DATA DEFINITION 

E EXTERNAL TEMPLATES 

F FUNCTION RETURN EXPRESSIONS 

L LABELS 

fl MULTIPLE DEFINITIONS 

p BLOCK DEFINITION 

S PROCEDURE/FUNCTION TEMPLATES 

T TASK DEFINITIONS 

U CALLS FROM UPDATE BLOCKS 

b MISCELLANEOUS 


CLASS Q: SHAPING FUNCTIONS 


A ARSAYNESS 

D DIMENSION INFORMATION 

S SUBSCRIPTS 

X ARGUMENT TYPE 


CLASS R: REAL TIME STATEMENTS 


E ON/SEND ERROR STATEMENTS 

T TIMING EXPRESSIONS 

U UPDATE BLOCKS 


CLASS S: SUBSCRIPT USAGE 


C SUBSCRIPT COUNT 

P PUNCTUATION 

Q PRECISION QUALIFIER 

R RANGE OF SUBSCRIPT VALUES 

S USAGE OF ASTERISKS 

T SUBSCRIPT TYPE 

V VALIDITY OF USAGE 


CLASS T: I/O STATEMENTS 


C CONTROL 

D DEVICE NUMBER 

b MISCELLANEOUS 
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CLASS U: UPDATE BLOCKS 

I IDENTIFIER OSAGE 

P PROGRAM BLOCKS 

T I/O 


CLASS V: COMPILE-TIME EVALUATIONS 

A ARITHMETIC OPERATIONS 

C CATENATION OPERATIONS 

E DNCOHPUT ABLE EXPRESSIONS 

P FUNCTION EVALUATION 


CLASS X: IMPLEMENTATION DEPENDENT FEATURES 

A PROGRAM ID DIRECTIVE 

D DEVICE DIRECTIVE 

I INCLUDE DIRECTIVE 

U UNKNOWN OR INVALID DIRECTIVE 
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ERROR HB5SAGES FOR MAJOR CLASSIFICATION A 

CLASSIFICATION "A" ERRORS ARE RELATED TO ASSIGNMENT STATEMENTS 

A A 1 -SEVERITY 1 

ARRAYNESS OF LEFT HAND SIDE' OF ASSIGNMENT DOES NOT HATCH THAT OF BIGHT HAND SIDE 
AA2 -SEVERITY 1 

ARRAYNESS OF ?? IS INCONSISTENT WITH THAT OF OTHER LEFT HAND SIDE VARIABLES 
AA3 -SEVERITY 1 

ARRAYNESS OF 7? DISAGREES WITH ARRAYNESS OF ITS SUBSCRIPTING 
AVO -SEVERITY 1 

ARGUMENTS ON EITHER SIDE OF NAHE ASSIGNMENT ARE INCOMPATIBLE. 

AVI -SEVERITY 1 

TYPE OF ?? IS ILLEGAL FOR ASSIGNMENT FROM GIVEN LEFT-HAND SIDE. 

A V2 -SEVERITY t 

MATRIX DIMENSIONS DISAGREE ACROSS ASSIGNMENT 
A V3 -SEVERITY 1 

VECTOR LENGTHS DISAGREE ACROSS ASSIGNMENT 
AV4 -SEVERITY 1 

TREE ORGANIZATIONS DO NOT HATCH ACROSS ASSIGNMENT 
A V5 -SEVERITY 1 

ONLY ONE OPERAND IN ASSIGNMENT IS A NAME PSEUDO-FUNCTION 

OR NULL. 

A 1 -SEVERITY 1 

ILLEGAL ASSIGNMENT TO CONSTANT OR PARAMETER 77 
A2 -SEVERITY 1 

7? POSSESSES SUBSCRIPTS ILLEGAL FOR THE ARGUMENT OF A NAME 
PSEUDO-FUNCTION IN ASSIGNMENT CONTEXT. 

A3 -SEVERITY 1 

?? DOES NOT POSSESS THE NAME ATTRIBUTE - IT IS THEREFORE 
ILLEGAL AS ARGUMENT OF A NAME PSEUDO-FUNCTION IN 
ASSIGNMENT CONTEXT. 
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ERROR 

MESSAGES FOR MAJOR CLASSIFICATION B 
CLASSIFICATION "8 M ERROFS RESULT FROM ABORTIVE 

COMPILER FAILURES 

BB1 

-SEVERITY 2 

INTERMEDIATE CODE STORAGE OVERFLOW; ERROR SCAN 

CONTINUING 

8N1 

-SEVERITY 3 

MAX NAME SCOPE NESTING DEPTH EXCEEDED 


BS 1 

-SEVERITY 3 

MAXIMUM DEPTH OF DO. ..END GROUP NESTING EXCEEDED 

BS2 

-SEVERITY 2 

INDIRECT PARSE STACK SIZE EXCEEDED 


8S3 

-SEVERITY 3 
PARSE STACK OVERFLOW 


BS4 

-SEVERITY 2 

CURRENT ARBAYNESS STACK SIZE EXCEEDED 


BS5 

-SEVERITY 1 

MAXIMUM FUNCTION NESTING DEPTH EXCEEDED 


BTl 

-SEVERITY 3 
SYMBCL TABLE OVERFLOW 


BT3 

-SEVERITY 3 

LITERAL TABLE DATA OVERfLOW 


BT4 

-SEVERITY 3 

LITEPAL TABLE STRING OVERFLOW 


BT5 

-SEVERITY 3 
MACRO TABLE OVERFLOW 


BT7 

-SEVERITY 2 

INITIAL LIST STORAGE CAPACITY EXCEEDED 


BX1 

-SEVERITY 2 
SYT_CLASS = 0 FOR ?? 


BX2 

-SEVERITY 2 
FUNC_TOKEN « 0 


BX4 

—SEVERITY 3 

TOO MANY BUILT-IN FUNCTIONS 

• 

BX5 

-SEVERITY 2 
EXT_ AFSAY OVERFLOW 


B1 

-SEVERITY 3 

INSUFFICIENT CORE AVAILABLE 


B2 

-SEVERITY 3 



INLINE FUNCTION HAT NOT BE IN A SUBSCRIPT OR EXPONENT. 
THIS ERROR IS IRRECOVERABLE. 
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ERROR CORPARISORS 

1 ‘wi'im'xi rare corparisor.abe ircorpatibee. 

| -SEVERITY 1 ‘ 

?? CCHPABISOHS BAY ONLY BE * OB -• 

ARRAYED COMPARISONS ARE RESTRICTED TO * OB 

J ‘tREe'oBGAHIZATIONS OB STRUCTURES COHPARSD DO ROT HATCH 

' 'o^y'oRE OPERAHO OB CORPARISOR IS A RARE PSEODO-BORCTIOR 

OB NULL, 
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ERROR MESSAGES FOR MAJOR CLASSIFICATION D 

CL AS SI FIC AT ION "D" ERRORS ARE RELATED TO DATA DECLARATIONS 

DAO -SEVERITY 1 

CONFLICTING ATTRIBUTE SPECIFIED WITH THE LATCHED ATTRIBUTE 
DAI -SEVERITY 1 

ILLEGAL ATTRIBUTE SPECIFIED FOR BIT OR BOOLEAN DATA TYPE 
DA10 -SEVERITY 1 

ILLEGAL ATTRIBUTE SPECIFIED FOB STRUCTURE DATA TYPE 
DA11 -SEVERITY 1 

CONFLICT BETWEEN ATTRIBUTES AND FUNCTION OR LABEL TYPE SPECIFICATION 
- ATTRIBUTES IGNORED 

DA2 -SEVERITY 1 

ILLEGAL ATTRIBUTE SPECIFIED FOR CHARACTER DATA TYPE 
DA20 -SEVERITY 1 

ILLEGAL ATTRIBUTE SPECIFIED FOR MINOR STRUCTURE ?? 

DA21 -SEVERITY 1 

AN ARRAY SPECIFICATION IS NOT ALLOWED FOR THE MINOR STRUCTURE ?? 

DA22 -SEVERITY 1 

NO ATTRIBUTES HAY BE SPECIFIED ON A NESTED STBUCTROE TEMPLATE REFERENCE 
DA23 -SEVERITY 1 

ILLEGAL ATTRIBUTE FOR THE STRUCTURE TERMINAL ?? 

DA24 -SEVERITY 1 

FACTORED AND NON-PACTORED ATTRIBUTE SPECIFICATIONS FOR ?? DISAGREE; 

THE NON-FACTORED ATTRIBUTES WILL BE GIVEN PRECEDENCE. 

DA25 -SEVERITY 1 . 

CONTRADICTORY PAIR OF ATTRIBUTES SUPPLIED - FIRST 
APPEARING ATTRIBUTE WILL BE USED 

D A3 -SEVERITY 1 

ILLEGAL ATTRIBUTE SPECIFIED FOR MATRIX DATA TYPE 
DA4 -SEVERITY 1 

ILLEGAL ATTRIBUTE SPECIFIED FOR VECTOR DATA TYPE 
DA5 -SEVERITY 1 

ILLEGAL ATTRIBUTE SPECIFIED FOR SCALAR DATA TYPE 
DA6 -SEVERITY 1 

ILLEGAL ATTRIBUTE SPECIFIED FOR INTEGER DATA TYPE 
DA9 -SEVERITY 1 

ILLEGAL ATTRIBUTE SPECIFIED FOR EVENT DATA TYPE 
DC1 -SEVERITY 1 

DECLARATION CONTAINS BOTH LABEL TYPE AND DATA TYPE SPECIFICATION 
- LABEL TYPE IGNORED, 

DC2 -SEVERITY 1 

THE ATTRIBUTES STATIC AND AUTOMATIC MAY NOT BE SECIFIED IN COMPOOL 
DECLARATIONS. 


M7< 
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DC3 


-SEVERITY 1 

THE PARAMETER 7? HAT HOT HAVE STATIC OB AUTOMATIC ATTRIBUTES SPECIFIED 


DC4 -SEVERITY 1 

FACTORED AND NON-FACTOBED TYPE SPECIFICATION FOB 7? DISAGREE 
THE NOH-FACTORED TYPE SPECIFICATION WILL BE USED 

DC5 -SEVERITY 1 

ACCESS ATTRI BUTES HAY ONLY BE QUALIFIED IN COHPOOL DECLARATIONS. 

OD1 -SEVERITY 1 

ILLEGAL ARRAY DIMENSION SPECIFICATION 

DD10 -SEVERITY 1 

* ARRAY SIZE IS ILLEGAL FOS 77 - ARRAY SIZE OF 2 ASSURED. 

DD11 -SEVERITY 1 

ILLEGAL FORM OF STRUCTURE DIMENSION SPECIFICATION 
DD12 -SEVERITY 1 

ILLEGAL CONTEXT FOR SPECIFICATION OF STRUCTURE COPIES 

DD3 -SEVERITY 2 

TOO MANY DIMENSIONS IN ARRAY 

DD4 -SEVERITY 1 

' INVALID MATRIX DIMENSION SPECIFICATION; A DIMENSION OF 3 IS ASSUMED 
DD5 -SEVERITY 1 

INVALID VECTOR LENGTH SPECIFICATION; A 3-VECTOB IS ASSUMED 
DD6 -SEVERITY 1 

ONLY SINGLE DIMENSION ARRAYS MAY USE THE * TO DENOTE UNKNOWN LENGTH 


DD7 -SEVERITY 1 

A * HAY NOT BE USED TO SPECIPY VECTOR LENGTH; A 3-VECTOR IS ASSUMED 
DD8 -SEVERITY 1 

* STRUCTURE COPY NOTATION IS ILLEGAL FOB 77 - 
STRUCTURE COPY SIZE OF 2 ASSUMED. 


DD9 -SEVEHITY 1 

A * HAY NOT BE USED TO SPECIFY A MATRIX DIMENSION; A DIMENSION OF 3 IS ASSUMED 
DF1 -SEVERITY 1 

THE FUNCTION 77 MAY NOT BE DECLARED IN A COHPOOL 

DF2 -SEVERITY 1 

ILLEGAL ATTRIBUTE FOR THE FUNCTION 77 


DF3 -SBVERITY 1 

THE FUNCTION 77 MAY NOT HAVE AN INITIAL/CONSTANT SPECIFICATION 
Oil -SEVERITY 1 

REPEAT FACTOR IN INITIALIZATION HAS NO LEGAL VALUE COMPUTABLE AT 
COMPILE TIME 


DUO -SEVERITY 1 

TOO MANY ELEMENTS SUPPLIED IN INITIAL LIST FOR 77 


ta s< 
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Dill 

-SEVERITY 1 

THE VARIABLE 7? USED IH A COMPILE-TIME EXPRESSION HAS SOT 3EEH PREVIOUSLY 
DEFINED 

Dll 2 

— SB VE HI TJ 1 

POBHAL PARAMETER 77 POSSESSES ILLEGAL ATTRIBUTES CONCERNING 
INITIALIZATION - ATTRIBUTES IGNORED, 


D 11 3 

-SEVERITY 1 

LABEL OP FUNCTION 77 POSSESSES ILLEGAL ATTRIBUTES CONCERNING 
INITIALIZATION - ATTRIBUTES IGNORED, 


DI14 

—SEVERITY 1 

IN AN INITIAL LIST, THE ARGUMENT OP A NAHE PSEUDO-FUNCTION 
HAY NCT POSSESS A SUBSCRIPT, 


DI15 

-SEVERITY 1 

IN AN INITIAL LIST, THE ARGUMENT OF A NAHE PSEUDO-FUNCTION 
HAY NOT POSSESS APRAYNESS. 


D 11 6 

-SEVERITY 1 

IN AN INITIAL LIST THE ARGUMENT OP A NAHE 
PSEUDO-FUNCTION HAY NOT POSSESS THE NAHE ATTRIBUTE. 


DI2 

■—SEVERITY 1 

IMPLIED NUMBER OF ELEMENTS IN INITIAL LIST EXCEEDS COMPILER LIMIT 


DI3 

-SEVERITY 1 

EXPRESSION IN INITIAL LIST IS NOT COMPUTABLE AT COMPILE TIME 


DI4 

—SEVERITY 1 

INITIALIZATION OP 7? HAS ILLEGAL TERMINATING * : 

NUMBER OF INITIAL YALUBS MATCHES TOTAL NUMBER OF ELEMENTS 


DI5 

-SEVERITY 1 

TOO FEN ELEMENTS SUPPLIED IM INITIAL LIST FOR 7? 


DI6 

-SEVERITY 1 ' _ 

ILLEGALLY-TYPED INITIAL VAL0E--IN ITI ALIZ ATION OF 77 EXPECTS 
A VALUE OF CHARACTER TYPE 


DI7 

-SEVERITY 1 

ILLEGALLY-TYPED INITIAL VALUE— INITIALIZATION OF 77 EXPECTS 
A VALUE OF BIT TYPE 


DI8 

-SEVERITY 1 

ILLEGALLY-TYPED INITIAL VALUB— INITIALIZATION OP 7? EXPECTS A 
VALUE OF INTEGER OR SCALAR TYPE 


DI9 

—SEVERITY 1 

THE DECLARATION OF 7? HAS BOTH FACTORED AND UNFACTORED INITIAL/COHSTANT 
ATTRIBUTES; THE UNFACTORED ATTRIBUTES WILL BE -USED 

DL1 

-SEVERITY 1 

?? COES NOT APPEAR IN A COMPOOL OR PROGRAM DECLARATION, 
AND IS NOT AN ASSIGN PARAMETER: THE LOCKING ATTRIBUTE 
SPECIFIED IS THEREFORE ILLEGAL, 


DL2 

j 

-SEVERITY 1 

THE LOCKED ATTRIBUTE HAY NOT BE USED IN CONJUNCTION WITH THE CONSTANT 

ATTRIBUTE 


i 

- ■ - >A 
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DL3 -SEVERITY 1 

ILLEGAL LOCK GROUP NURBER SPECIFIED 

DKl -SEVERITY 1 

PROGRAM; TASK, OR PROCEDURE -DECLARATION FOR 77 DOES SOT CONTAIN RARE ATTRIBUTE 
DN2 -SEVERITY 1 

THE HARE ATTRIBUTE RAY NOT BE USED IS THE DECLARATION 
OF TEMPORARIES - ATTRIBUTE IGNORED. 

DOI -SEVERITY 1 

FIRST NODE DECLARED IN TEMPLATE HOST BE AT LEVEL 1 
DOI 0 -SEVERITY 1 

STRUCTURE ?? MAY NOT BE A TERPOFARY SINCE ITS TEHPLATE CONTAINS 
AT IEAST ONE TERMINAL NODE WITH THE NAME ATTRIBUTE. 

D02 -SEVERITY 1 

ILLEGAL SEQUENCE OF LEVEL NUMBERS IN TEHPLATE 
DQ3 -SEVERITY 1 

NAME OF STRUCTURE TEMPLATE CAUSES UNQUALIFICATION IN AN ILLEGAL CONTEXT 
DQ4 -SEVERITY 1 

STRUCTURE 77 CANNOT BE UNQUALIFIED - STRUCTURE TEHPLATE IS ALREADY USED 
BY AN UNQUALIFIED STRUCTURE ' 

DOS -SEVERITY 1 

STRUCTURE ?? CANNOT BE UNQUALIFIED - STRUCTURE TEMPLATE IS NOT 
IN SAME NAME SCOPE 

D06 -SEVERITY 1 

STRUCTURE 77 CANNNOT BE UNQUALIFIED - STRUCTURE TEHPLATE CONTAINS 
A REFERENCE TO ANOTHER STRUCTURE TEMPLATE, 

DQ7 -SEVERITY 1 

THE DECLARED NAME 77 DUPLICATES THE NAME OF A NODE OF THE 
TEHPLATE OF AN UNQUALIFIED STRUCTURE PREVIOUSLY DECLARED 
IN THE SAME NAME SCOPE: THIS CAUSES THE UNQUALIFICATION TO BECOME 
ILLEGAL. 

DOS -SEVERITY 1 

STRUCTURE 77 CANNOT BE UNQUALIFIED - STRUCTURE TEMPLATE CONTAINS 
AT LEAST ONE NARE NOT UNIOUE TO THE HARE SCOPE 

D09 -SEVERITY 1 

THE DECLARED NODE 7? DUPLICATES A PREVIOUSLY DECLARED NODE NAME - 
CAUSING QUALIFIED REFERENCES TO THE TWO NODES TO BE INDISTINGUISHABLE 

DS1 -SEVERITY 1 

INVALID BIT-LENGTH SPECIFICATION 

DS10 -SEVERITY 1 

FACTORED AND NON-FACTORED STRUCTURE TEMPLATE REFERENCES DISAGREE} 

NON-FACTORED REFERENCE WILL BE USED 

D Si 1 -SEVERITY 1 

INPUT/ASSIGN PARAMETERS OF CHARACTER TYPE CAN ONLY BE GIVEN A * LENGTH 
SPECIFICATION 
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DS2 

-SEVERITY 1 

INVALID CHAR-LENGTH SPECIFICATION 


DS3 

-SEVERITY 1 

A * IS AS ILLEGAL CHARACTER LENGTH SPECIFICATION? A LENGTH OF 8 

IS ASSURED 

DS4 

-SEVERITY 1 

A * IS AN ILLEGAL BIT LENGTH SPECIFICATION; A LENGTH OP 1 IS ASSURED 

DS5 

-SEVERITY 1 

FACTORED AND SON-FACTORED BIT SIZE SPECIFICATION FOR ?? DISAGREE 
THE NCN-FACTORED SPECIFICATION SILL BE USED 

DS6 

-5E7ER ITY 1 

FACTORED AND NON-FACTORED CHARACTER LENGTH SPECIFICATION POP 7? 
THE NCN-FACTORED SPECIFICATION WILL BE USED 

DISAGREE 

D 57 

-SEVERITY 1 

FACTORED AND NON-FACTORED MATRIX DIMENSION SPECIFICATION FOR 77 
THE NCN-FACTORED SPECIFICATION WILL BE USED 

DISAGREE 

OSS 

-SEVERITY 1 

FACTORED AND NON-FACTORED VECTOR DIMENSION SPECIFICATION FOR 7? 
THE NON-FACTORED SPECIFICATION WILL BE USED 

DISAGREE 

0 S9 

-SEVERITY 1 

THE FACTORED AND NON-FACTORED STRUCTURE DIMENSION SPECIFICATION 
THE NON-FACTORED SPECIFICATION WILL BE USED 

FOR 7? DISAGREE 

DTI 

-SEVERITY 1 

CONFLICTING TYPE SPECIFICATIONS FOR 77 


DT2 

-SEVERITY 1 

A REFERENCE TO A PREVIOUS TEMPLATE HAY NOT APPEAR IN THE CONTEXT 
MINOR STRUCTURE 

OP A 

DT3 

-SEVERITY 1 

LABEL TYPE CONFLICT FOR 77 


DT4 

-SEVERITY 1 

ILLEGAL CHARACTER; HEX REPRESENTATION IS 77 


DT5 

-SEVERITY 1 

A TYPE SPECIFICATION HAY NOT BE USED ON THE HINOR STRUCTURE 7? 


DT6 

-SEVERITY 1 

A STRUCTURE TEMPLATE MAY NOT CONTAIN A REFERENCE TO ITSELF 


DT7 

-SEVERITY 1 

ILLEGAL TYPE FOR THE STRUCTURE TERMINAL 77 


DT8 

-SEVERITY 1 

77 IS EVENT TYPE AND MAY NOT THEREFORE BE AN INPUT PARAMETER 


DOl 

-SEVERITY 1 

UNDECLARED IDENTIFIES 77 


DU2 

-SEVERITY 1 

UNDECLARED PARAMETER ?? 
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D03 


SEVERITY 0 

?7 IS HOT A PARAMETER A HD CANNOT BE DECLARED IH A TEMPLATE 


DU4 -SEVERITY 1 

HO TYPE INFORMATION AVAILABLE FOR 77 
A DEFAULT TYPE HAS BEEN ASSIGNED 

DOS -SEVERITY 1 

BEPERENCE TO UNDECLARED STRUCTURE TEMPLATE 77 
D 1 -SEVERITY 1 

THE TYPE SPECIFICATION FOR THE PARAMETER 77 IS ILLEGAL 

DIO -SEVERITY 1 

TEMPORARY STATEMENTS MAY NOT APPEAR AT THE OPENING OF A DO CASE.. .BHD 
GROUP 

Dll -SEVERITY 1 

TYPE SPECIFICATION OF 77 BENDERS NONHAL ATTRIBUTE ILLEGAL 
ATTRIBUTE IGNORED. 

D 12 -SEVERITY 1 

DECLARATION OF 77 SPECIFIES ATTRIBUTES INCOMPATIBLE HITH THE 
NAME ATTRIBUTE. 

D13 -SEVERITY 1 

DECLARATION OF 77 HAS CONFLICTING FACTORED AND UNFACTORED NONHAL 
ATTRIBUTES - UNFACTORED ATTRIBUTE HILL BE USED. 

D2 -SEVERITY 1 

THE PROCEDURE OR FUNCTION ?? HAY NOT BE DECLARED IN A COHPOOL 
D 3 -SEVERITY 1 

THE DECLARATION OF PROCEDURE 7? MAY NOT POSSESS FACTORED ATTRIBUTES 

D4 -SEVERITY 1 

ARRAY SPECIFICATION ILLEGAL FOR 7? 

D5 -SEVERITY 1 

77 HAS BOTH FACTORED AND NONFACTORED LOCK GROUP 
SPECIFICATION - NON-FACTORED SPECIFICATION HILL 
BE USED. 

D6 —SEVERITY 1 

THE DECLARATION OF ?? HAS BOTH FACTOHED AND NON-FACTORBD ARRAY SPECIFICATIONS; 
THE NON-FACTORED SPECIFICATION HILL BE USED 

D7 -SEVERITY 1 

TEMPORARY STATEMENT DOBS NOT APPEAR BEFORE THE FIRST EXECUTABLE STATEMENT 
OF THE ENCLOSING DO. ..END GROUP 

D8 -SEVERITY 1 

DECLARATION OF 7? SPECIFIES TYPE OR ATTRIBUTES NOT LEGAL 
FOR TEMPORARIES 

I 

D9 -SEVERITY 1 

TEMPORARY 77 HAS AN ILLEGAL TYPE SPECIFICATION. 
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EBROH 

) 

EAl 

V 

/ 

EB1 

) 

EB2 

EC1 

EC2 

EC3 

EDI 

ED2 

ELI 

EL2 

EH1 

EH2 

Efl3 

EH4 

ENl 

E Hi 0 

ENl 1 

EN12 


MESSAGES FOB MAJOR CLASSIFICATION B 
CLASSIFICATION "E" ERRORS DEAL WITH EXPRESSIONS 

-SEVERITY 1 

ARRAYNESS OF 7? IS INCONSISTENT WITH CURRENT ABRAYHESS OF EXPRESSION 
-SEVERITY 0 

RESULT OF BIT CATENATION HILL BE LEFT TRUNCATED TO MAXIMUM BIT LENGTH 
-SEVERITY 1 

LABEL ?? USED IN BIT OR EVENT EXPRESSION HAS NOT A PROGRAM OR TASK EVENT 


-SEVERITY 1 

CROSS PRODUCT MUST BE BETHEEN THREE DIMENSIONAL VECTORS 
-SEVERITY 1 

CROSS PRODUCT * USED WITHOUT A VECTOR AFTER IT 
— SEVERITY 1 

CROSS PRODUCT * USED WITHOUT A VECTOB BEFORE IT 
-SEVERITY 1 

DOT PRODUCT . USED WITHOUT A VECTOR AFTER IT 
-SEVERITY 1 

DOT PRODUCT « USED WITHOUT A VECTOR BEFORE IT 
-SEVERITY 1 

ONLY ARITHMETIC CONVERSION FUNCTIONS HAY POSSESS ARGUMENTS WITH REPEAT FACTORS 
-SEVERITY 1 

REPETITION FACTOR OP EXPRESSION MUST BE AW UNARBAYED INTEGER OR SCALAR 
EXPRESSION COMPUTABLE AT COMPILE TIME 

-SEVERITY 1 

DIMENSIONS OF MATRIX OPERANDS IN EXPRESSION DISAGREE 
-SEVERITY 1 

MATRIX ARITHMETIC TYPE CANNOT BE CONVERTED TO A CHARACTER STRING 
-SEVERITY 1 

MATRIX-MATRIX MULTIPLICATION DIMENSION DISAGREEMENT 
-SEVERITY 1 

INVERSE OF NON-SQUARE MATRIX ATTEMPTED 
-SEVERITY 1 

THE ARGUMENT OF A NAME PSEUDO-FUNCTION MAY NOT BE A 
NAME PSEUDO-FUNCTION. 

-SEVERITY 1 

?? IS A TEMPORARY AND HAY NOT THEREFORE BE THE 
ARGUMENT OP A NAME PSEUDO-FUNCTION. 

-SEVERITY 1 

?? IS A CONSTANT OR INPUT PARAMETER AND HAY NOT 
THEREFORE BE THE ARGUMENT OF A NAME PSEUDO-FUNCTION. 

-SEVERITY 1 

ACCESS RIGHTS HAVE BEEN DENIED TO ?? - ITS USE 
IN A NAME PSEULO-FUNCTION IS THEREFORE ILLEGAL. 


1S3< 
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BN13 


-SEVERITY 1 

7? IS WOT A HA JOB STRUCTURE BOT POSSESSES STBUCTUBE 
COPIES - IT IS THEREFORE ILLEGAL AS THE ARGUMENT 
OF A NAME $SEUDO-V ARI ABLE. 


EN1 4 -SEVERITY 1 

THE ARGUMENT OF A NAME PSEUDO-PUNCTION MAT NOT POSSESS 
A PRECISION MODIFIER. 


EN2 -SEVERITY 1 

THE ARGUMENT OF A NAME PSEUDO-FUNCTION HAT NOT BE 
A SUBBIT PSEUDO-VARIABLE. 


BN3 -SEVERITY D 

THE PROCEDURE ?? POSSESSES PARAMETERS AND THUS BAT NOT 
BE USED AS THE ARGUMENT OF A NAME PSEUDO-FUNCTION. 

EN4 -SEVEPITT 1 

THE TYPE OP THE LABEL 77 IS ILLEGAL AS THE 

ARGUMENT OF A NAME PSEUDO-FUNCTION. 

EN5 -SEVERITT 1 

NONHAL PROCEDURE OR FUNCTION ?? MAT NOT BE THE 
ARGUMENT OF A NAME PSEUDO-FUNCTION. 


EN6 -SEVERITY 1 

' PROCEDURE OR FUNCTION ?? IS NOT EXTERNAL AND THEREFORE 

MAY NOT BE THE ARGUMENT OF A NAME PSEUDO-FUNCTION. 

E N7 -SEVERITY 1 

77 POSSESSES SUBSCRIPTING ILLEGAL POR THE ARGUMENT 
OF A NAME PSEUDO-FUNCTION. 

EN8 -SEVERITY 1 

77 HAS THE ATTFIBUTE DENSE AND MAY NOT THEREFORE 
BE THE ARGUMENT OF A NAME PSEUDO-FUNCTION, 


EN9 —SEVERITY 1 

?? IS A MINOR NODE OF A STRUCTURE AND BAY NOT 
THEREFORE BE THE ARGUBENT OF A NAME PSEUDO-PUNCTION. 


EOI -SEVERITY 1 

ILLEGAL PRODUCT: OUTER PRODUCT TIMES A VECTOR 
B02 —SEVERITY 1 

A PRODUCT INVOLVING BOTH CROSS AND OUTER PRODUCTS IS INDICATED. 
USB MORE PARENTHESES. 


E03 -SEVERITY 1 

A PRODUCT INVOLVING BOTH DOT AND OUTER PHODUCTS IS INDICATED. 
USE MORE PARENTHESIS. 


E VI -SEVERITY 1 

LENGTHS OF VECTOR OPERANDS IN EXPRESSION DISAGREE 
SV2 -SEVERITY 1 

MATRIX-VECTOR MULTIPLICATION DIMENSION DISAGREEMENT 
SV3 -SEVERITY 1 

VECTOR-MATRIX MULTIPLICATION DIMENSION DISAGREEMENT 
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2V4 -SEVERITY 1 

VECTOB HAY MOT HAVE AM EXPONENT 


EV5 


epvEBITY 1 

VECTOB ARITHHETIC TYPE CANNOT BE CONVERTED TO A 


CHARACTER STRING 


El 


Deisms Iaj only be of integer or scalar tyre 


E2 


B»TRIX T HnST HAVE AN EXPONENT OF INTEGER TYPE KNOWN AT COHPILE TINE 


E 3 


-SEVERITY 1 
EXPONENT HOST BE A 


SINGLE VALOED QUANTITY 


'oo^n”r2sS PRODUCT SYNBOL op .) USED IN A PRODUCT NOT INYOLVIHG VECTORS 
INCOMPATIBLE APITHHETIC OPERAND TYPES IN EXPRESSION 


155 < 
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SHBOB MESSAGES BOH HAJOB CLASSIFICATION P 

CLASSIFICATION *P" ERROHS DEAL WITH PORRAL PARAMETERS AND ARGUMENTS 


PEI -SEVERITY 1 

RATS IX DX SESSIONS OP ARGUHENT AHD CORRESPONDING PORRAL PABAHETER DO MOT AGREE 
PD2 -SEVERITY 1 

VECTOR LENGTHS OP ARGUMENT AND CORRESPONDING PORRAL PARANETER DO NOT AGBEE 
FD3 -SEVERITY 1 

TREE ORGANIZATIONS 07 STROCTOBE ARGUHENT AND COBBESPONDING PORRAL PABARETEB ABE 
NOT IDENTICAL 

PD4 -SEVERITY 1 

ARRAYNESS OP PDNCTION ARGUHENT DOES NOT HATCH CURRENT ABRAYNESS OP EXPRESSION 
CONTAINING THE INVOCATION 

FES -SEVERITY 1 

ARRAYNESS OP ARGUHENT AND CORRESPONDING PORRAL PARARETER ARE NOT IDENTICAL 
FD6 -SEVERITY 1 

ARGUHENT OF ?? FUNCTION IS HOT A SQUARE HAT5IX 
FD7 -SEVERITY 1 

A NAME PSEUDO-FUNCTION HAY NOT POSSESS MULTIPLE COPIES IF 
AN ARGUMENT OF A PROCEDURE CALL. 

PN1 -SEVERITY 1 

FUNCTION 7? HAS INVOKED WITH TOO FEW ARGUMENTS 
PN2 -SEVERITY 1 

FUNCTION 7? WAS INVOKED WITH TOO MANY ARGUMENTS 

FN3 -SEVERITY 2 

7? USED MORE THAN ONCE AS A PARAMETER 

FN4 -SEVERITY 1 

?? FUNCTION HAS INCORRECT NUMBER OF ARGUMENTS 
PS1 -SEVERITY 1 

AN ASSIGN ARGUHENT OF A PROCEDURE CALL MAY NOT BE A SUBBIT PSEUDO 
VARIABLE 

PS2 -SEVERITY 1 

THE STRUCTURE COPIES OF ASSIGN ARGUHENT ?? HUST BE SUBSCRIPTED 
AWAY 

PTO -SEVERITY 1 

NAME APGUMENT HAS PROPERTIES INCOMPATIBLE WITH 
CORRESPONDING NAME FORMAL PARAMETER. 

FT1 -SEVERITY 1 

TYPE OF FUNCTION ARGUMENT IS INCOMPATIBLE WITH TYPE OF CORRESPONDING 
FORMAL PARAMETER 

FT10 -SEVERITT 1 

A NAME PSEUDO-FUNCTION HAY NOT BE THE ARGUMENT OF. A 
BUILT-IN OR SHAPING/CONVERSION FUNCTION. 

PT12 -SEVERITY 1 

ONE OF THE FOLIOWING IS TRUE; 

, ARGUMENT CORRESPONDING TO NAME FORMAL PARAMETER 


IS NOT A NAME PSEUDO-FUNCTION OR NULL; 

.NAHE PSEUDO-FUNCTION OR NULL ARGUHENT CORRESPONDS 
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FT2 

FT3 

FT4 

FT 6 

FT7 

FT8 

PT9 


TO FOB HAL PARAMETER WITH BO BABE ATTRIBUTE. 
-SEVERITY 1 

?? FUNCTION HAS AH ABGUHEHT OF INCORRECT TYPE 
“SEVERITY 1 

ILLEGAL TYPE FOR THE FUHCTIOB ?? 


1he EB siL 1 si-bcipic»tioi. fob the fetueh ttpe of fmctiob ft disbobees with the 

PREVIOUSLY DECLARED SIZE 


“SEVERITY 1 
THE STRUCTURE 
DISAGREES WITH 


TEMPLATE INDICATED 
THE TEMPLATE USED 


IB THE TYPE SPECIFICATION 
IB A PREVIOUS DECLARATION 


OF FUNCTION 77 


-SIEJSlI. SIHG1E/DODBLE SPECIFICATIOH FOB THE FOHCTIOH ?? 


77 fl»7 HOT POSSESS A SBBSCHIPT OH PBECISIOH QUALIFIER. 
"tH^IBYOCATIOH OP HAHE PBOCEBOBE 77 HAT HOT POSSESS AHSUHEHTS. 


±S?< 
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ERROR MESSAGES FOB MAJOR CLASSIFICATION G 

CLASSIFICATION "G" ERRORS DEAL WITH STATEMENT GROUPINGS (DO STATEMENTS) 

GBl -SEVERITY 1 

BIT EXPRESSION IN ?? CLAUSE BUST BE BOOLEAN 
GCl -SEVERITY 1 

CONTROL EXPRESSION IN A DO CASE MOST BE OP UNABRATED INTEGER OR SCALAR TYPE 
GC2 -SEVERITY 1 

BIT EXPRESSION IN WHILE OR UNTIL CLAUSE BAY NOT BE ARRAYED 
GC3 -SEVERITY 1 

CONTROL EXPRESSIONS IN A DO FOR HUST BE OF UNABBAYED INTEGER OR SCALAR TYPE 
GE1 -SEVERITY 1 

EXIT IS EITHER NOT IN A DO*. .END GROUP* OR NO LABEL 
HATCH WAS POUND. 

GE2 -SEVERITY 1 

BEPEAT IS EITHER NOT IN A DO FOR. ..END OH DO WHILE/UHTIL. . . END 
GROUP, OP NO LABEL HATCH WAS FOUND. 

GE3 -SEVERITY 1 

EXIT CAUSES ILLEGAL BRANCHING OUT OF CODE BLOCK DEFINITION 
GEtt -SEVERITY 1 

REPEAT CAUSES ILLEGAL BRANCHING OUT OF CODE BLOCK DEFINITION 
GL1 -SEVERITY 1 

LABEL AFTER END STATEMENT DOES NOT MATCH DO STATEMENT LABEL 
GL2 -SEVEBITY 1 

LABEL IS THE DESTINATION OF A GO TO FROM OUTSIDE THE ENCLOSING DO. ..END GROUP 

GL3 -SEVERITY 1 

GO TO STATEMENT CAUSES A BRANCH INTO A DO. • , END GROUP 


GV1 -SEVERITY 1 

CONTROL VARIABLE IN A DO FOR HUST BE OF UNARRAYED INTEGER OB SCALAR TYPE 


158 < 
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BBBOE MESSAGES FOB HAJOB CLASSIFICATION I 

CLASSIFICATION "I" ERRORS ARE BELATED TO IDENTIFIERS 

U1 “SEVERITY 1 

IDENTIFIER BANE NAY NOT END . NTH AN UNDERSCORE CHARACTER 

IL2 -SEVERITY 1 

NAME TOO LONG - TRUNCATED 

IR 1 -SEVERITY 1 

ILLEGAL REPLACEMENT FOB LOCAL NAME; 77 
IR10 “SEVERITY 3 

MAXIMUM NUMBER OF PARAMETERS FOR SOURCE MACRO DEFINITION EXCEEDED 

IP 3 -SEVERITY 1 

MACRO EXPANSION TOO LONG 

IRS -SEVERITY 1 

DUPLICATE REPLACE FOB 7? 

IRS -SEVERITY 1 

MACRO NAME 7? NOT DEFINED 

IR7 -SEVERITY 2 

REPLACE PARAMETER STRING TOO LONG; REPLACE NOT PERFORMED 
IBS -SEVERITY 2 

INCORRECT NUMBER OF PABAMETERS FOR MACRO CALL; REPLACEMENT NOT PERFORMED 
IR9 -SEVERITY 3 

MACRO EXPANSION STACK OVERFLOW; RECURSIVE DEFINITION LIKELY 
IS1 -SEVERITY 1 

ILLEGAL CONSTRUCTION OF QUALIFIED STRUCTURE NAME 


1S3« 
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ERROR MESSAGES FOB MAJOR CLASSIFICATION L 

CLASSIFICATION "L** ERRORS DEAL WITH LITERALS 


LB1 

-SEVER ITT 1 

BIT CONSTANTS HAY NOT BE LONGER THAN 32 BITS 


LB2 

“SEVERITY 1 

DECIMAL BIT CONSTANT BUST SPECIFY OR IMPLY A REPETITION 

FACTOR OF 1 

LB3 

“SEVERITY 1 

ILLEGAL DECIMAL STRING IN DECIMAL BIT CONSTANT 


LBU 

“SEVERITY 1 

ILLEGAL CHARACTER IN DECIMAL BIT CONSTANT 


LBS 

-SEVERITY 1 

ILLEGAL CHARACTER IN BINARY BIT CONSTANT 


LB6 

-SEVERITY 1 

ILLEGAL CHARACTER IN OCTAL BIT CONSTANT 


LB7 

-SEVERITY 1 

ILLEGAL CHARACTER IN HEXADECIMAL BIT CONSTANT 


LBS 

—SEVERITY 1 

REPETITION FACTOR OF A BIT LITERAL HOST BE GREATER THAN 

ZERO 

LC2 

-SEVERITY 1 

?? NOT EXPRESSIBLE INTERNALLY 


LFl 

—SEVERITY 1 

ILLEGAL NUMERIC LITERAL CONSTRUCTION 


LF2 

-SEVERITY 1 

ONLY ONE DECIMAL POINT ALLOWED 


LF3 

-SEVERITY 1 

TOO MANY SIGNIFICANT DIGITS - 74 ALLOWED 


LF5 

-SEVERITY 1 

EXPONENT INDICATOR BOT NO EXPONENT DIGITS 


LSI 

-SEVERITY 0 

CHARACTER STRING TOO LONG - TRUNCATED TO 255 CHARACTERS 


LS2 

—SEVERITY 1 

REPETITION FACTOR OF A CHARACTER LITERAL IS NOT GREATER 

THAN ZERO 
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ERROR MESSAGES FOB MAJOR CLASSIFICATION M 

CLASSIFICATION "M" ERRORS DEAL WITH MULTI-LIRE FORMATS 


MCI 

^SEVERITY 1 

ILLEGAL CONTEXT FOR OVSRPUNCH 


MC2 

-SEVERITY 1 

QVE RPUNCH ILLEGAL ON FUNCTION NAMES 


MC3 

-SEVERITY 1 

OVERPUNCH ILLEGAL ON REPLACED NAME 


MC4 

-SEVERITY 0 

OVERPUNCH NOT VALID OH RESERVED WORD ?? 


nc5 

-SEVERITY 0 

OVEFPUNCH ILLEGAL ON PARAMETER ?? 


HC6 

-SEVERITY 0 

OVERPUNCH ILLEGAL IN DECLARATION OP 7? 


HE1 

—SEVERITY 3 

EXPONENT STRING OVERFLOW 


HE2 

-SEVERITY 1 

E-LINE CHARACTER MORE THAN ONE LINE ABOVE 

PRECEDING CHARACTER 

HE3 

-SEVERITY 1 

E-LINE OVERLAPS H-LINE 


ME4 

-SEVERITY 1 

OVERLAPPING E-LINE CHARACTERS 


MOI 

-SEVERITY 0 
OVERPUNCH ILLEGAL 


M02 

-SEVERITY 1 

INVALID OVERFUNCH ON 7? 


H03 

-SEVERITY 0 

MULTI FLE OVE FPUNCHES NOT VALID - FIRST ACCEPTED 

M04 

-SEVERITY 1 

US2S SUPPLIED OVERPUNCH CHARACTER NOT VALID - IGNORED 

MSI 

—SEVERITY 3 

SUBSCRIPT STRING OVERFLOW 


MS2 

-SEVERITY 1 

S-LINE CHARACTER MORE THAN ONE LINE LOWER 

THAN PRECEDING CHARACTER 

MS3 

-SEVERITY 1 

S-LINB OVERLAPS M-LINE 

• 

HS4 

—SEVERITY 1 

OVERLAPPING S-IINE CHARACTERS 


Ml 

—SEVERITY 0 

ILLEGAL CARD TYPE - CHANGED TO A COMMENT 
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^-SEVERITY 1 

INVALID SEQUENCE OP CARD TYPES 
•SEVERITY 0 

CONBBNT LONG EH THAN 256 CHARACTERS - HAS BEEN TRUNCATED 


15 
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ERROR 

PA1 

PA2 

PCI 

PC2 

PCI 

PEI 

PE2 

PF1 

PF2 

PF3 

PF4 

PF5 

PF6 

PF7 

PF8 

PF9 

PL1 

PL2 


MESSAGES FOR MAJOR CLASSIFICATION P 
CLASSIFICATION "P" ERRORS INDICATE FLOW CONTROL PROBLEBS 

—SEVERITY 0 

A MEMBER CORRESPONDING TO THE PROGRAM IDENTIFICATION 7? CAHNOT BE FOUND 
IN THE PROGRAM ACCESS FILE. NO ACCESS VALIDATION BILL BE PERFORMED, 

-SEVERITY 0 M 

PROCESSING OF THE PROGRAM ACCESS FILE FOR PROGRAM ID 7? HAS 
CAUSED DETECTION OF ONE OR MORE ERRORS AND/OR INCONSISTANCIES 
WHICH ARE LISTED BELOW: 

—SEVERITY 1 

COMPOOL BLOCK CONTAINS STATEMENT (S) OTHER THAN DECLARATIONS 
—SEVERITY 1 

COMPCOI TEMPLATE CONTAINS STATEMENT (S) OTHER THAN DECLARATIONS 
-SEVEPITY 1 

ILLEGAL DECLARATION FOR THE PARAMETER ?? 

-SEVERITY 1 

EXTERNAL TEMPLATES MUST NOT APPEAR WITHIN A BLOCK DEFINITION 
—SEVERITY 1 

EXTERNAL TEMPLATES HOST NOT BE PLACED AFTER A BLOCK DEFINITION 
-SEVERITY 1 

RETURN FROM FUNCTION BLOCK MUST BE FOLLOWED BY AN EXPRESSION 
-SEVERITY 1 

RETURN may ONLY BE FOLLOWED BY AN EXPRESSION IN A FUNCTION BLOCK 
-SEVERITY 1 

EXPRESSION TO EE RETURNED MAY NOT POSSESS AHRAYNBSS 
—SEVER IT Y 1 

ILLEGAL TYPE CONVERSION OP RETURNED EXPRESSION REQUIRED 
-SEVERITY 1 

MATRIX DIMENSIONS OP FUNCTION DISAGREE WITH THOSE OF RETURN EXPRESSION 
—SEVERITY 1 

VECTOR LENGTH OF FUNCTION DISAGREES WITH THAT OF RETURN EXPRESSION 
-SEVERITY 1 

TREE ORGANIZATION OF FUNCTION DOES NOT HATCH THAT OF RETURN EXPRESSION 
-SEVERITY 1 

IN A DEREFERENCING CONTEXT, THE BLOCK NAME ?? HAY NOT 
POSSESS SUBSCRIPTING HAVING ARRAYNESS 

-SEVEPITY 1 

RETURN EXPRESSION MAY NOT BE A NAME PSEUDO-FUNCTION 
OR NULL. • 

-SEVERITY 1 

THE FUNCTION ?? HAS BEEN DECLARED BUT NOT DEFINED 
-SEVERITY 2 

77 IS A DUPLICATE LABEL 


LS3< 
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P13 

Pttt 

PL5 

PL6 

PL7 

PHI 

PH3 

PH4 

PP1 

PP10 

PP11 

PP2 

PP3 

PPM 

PP5 

PP6 

PP7 

PPB 

PP9 


"SEVER ITT 1 

LABEL CM CLOSE DOES MOT HATCH BLOCK DEFINITION LABELS 77 
-SEVEBITY 1 

FUNCTION LABEL CONFLICT 
•SEVERITY 1 

LABEL 77 IS HOT DEFINED WITHIN THE CURRENT SCOPE 
•SEVERITY 1 

A DEFINITION BLOCK FOR THE PROCEDURE OR TASK 77 IS ABSENT FROH 
THE COMPILATION 

•SEVERITY 1 

USED IN A CALL STATEMENT, PROCEDURE LABEL 77 HAT NOT 
POSSESS ARRAYNESS. 


-SEVERITY 2 

DUPLICATE DEFINITION FOB 77 
-SEVERITY 1 

EARLIER DEFINITION OV?RRIDDBN FOR 7? 


-SEVERITY 0 

OUTER DEFINITION OVERBIDDEN FOB 77 


•SEVER ITT 1 

A ?? DEFINITION HOST BE THE 


OOTERflOST BLOCK DEFINITION 


'SEVERITY 2 
INLINE FUNCTIONS 


HAY NOT BE NESTED WITHIN INLINE FUNCTION BLOCKS. 


■SEVERITY 2 

INLINE FUNCTIONS HOST NOT APPEAR IN EXPRESSIONS WHICH ARB 
REQUIRED TO BE COHPILE TIHE EVALUABLE - THIS ERROR IS RECOVERABLE 


-SEVERITY 1 

BLOCK DEFINITION IS NOT THE FIRST OOTERBOST 


BLOCK DEFINITION 


—SEVERITY 1 

A 7? DEFINITION CANNOT BE AN OUTERMOST BLOCK DEFINITION 
•SEVERITY 1 

NO BLOCK DEFINITIONS WERE ENCOUNTERED IN COflPILATIOM 
—SEVERITY 1 

AN INLINE FUNCTION MAY NOT CONTAIN AM I/O STATEHENT. 
-SEVERITY 1 

AN INLINE FUNCTION HAY NOT CONTAIN A REAL TIHE STATEHENT. 
—SEVERITY 1 

AN INLINE FUNCTION HAY NOT CONTAIN A PROCEDURE CALL. 


AN INLINE FUNCTION HAY NOT CONTAIN A USER PUNCTION INVOCATION. 
'SE VERIT Y 1 

AN INLINE FUNCTION HAY NOT CONTAIN A PROCEDURE OR FUNCTION 
DEFINITION BLOCK. 
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PS1 

PS2 

PS3 

PSU 

PS5 

PS6 

PS7 

PS8 

PS9 

PT1 

PU3 

Pi 

P3 

Ptt 

P5 

P6 


-SEVERITY 1 

EXTERNAL PROCEDURE/FUNCTIOH TEMPLATE C0WAI8S STATEMENT (S) 
OTHER THAN DECLARATIONS 

-SEVERITY 1 

ONLY PROCEDURES OR FUNCTIONS HAY BE DESIGNATED 7? 
-SEVERITY 1 

ILLEGAL ACCESS ATTRIBUTE OR BLOCK HEADEB. 


'SEVERITY 0 

THE ACCESS ATTRIBUTE HAY ONLY BE USED ON THE DEFINITION 
OP AN OUTERMOST BLOCK, 


-SEVERITY 1 
THE PEOGRAH NAHED 77 
COMPILATION UNIT IS 


IS ACCESS CONTROLLED, THE CURRENT 
NOT AUTHORIZED TO SCHEDULE THIS PROGRAM 


—SEVER ITY 1 

THE PRCCEDURE NAHED 7? IS ACCESS CONTROLLED. THE 
COMPILATION UNIT IS NOT AUTHORIZED TO CALL THIS PROCEDURE. 


THT~FUNCTION NAHED 7? IS ACCESS CONTROLLED. 

THE CUF PET COMPILATION UNIT IS NOT AUTHORIZED TO INVOKE 
THIS FUNCTION. 


SE VEH IT Y 1 

THE VARIABLE NAHED 77 IS ACCESS CONTROLLED. THE 
COMPILATION UNIT IS HOT AUTHORIZED TO CHANGE THE 
OF THIS VARIABLE, 


CURRENT 

VALUE 


SEV^ITY 1 

VARIABLE 7? IS DEPINED WITHIN A COMPOOL BLOCK WHICH IS 
ACCESS PROTECTED. THE VARIABLE HAY NOT BE USED BY THIS 
COMPILATION UNIT. 


’S E V ER ITY 1 

TASK DEFINITIONS OR DECLARATIONS HAY ONLY APPEAR IN 
THE OUTER MOST BLOCK OF A PROGRAM COMPILATION 

■SEVERITY 1 „ 

INVOCATIONS IN AN UPDATE BLOCK OF PROCEDURES OH U5ER FUNCTIONS DEPINED 

OUTSIDE THE BLCCK ARE ILLEGAL 

■SEVERITY 1 

END-0F-FIL2 AT INVALID POINT IN SOURCE TEXT 


-SEVERITY 0 

BLOCK SUMMARY TABLE OVEBPLOW 

-SEVERITY 2 
CONFLICTING USE OF 77 

—SEVERITY 1 

TOO MANY MACRO EXPANSIONS FOR 77 
-SEVERITY 0 

PROGRAM LAYOUT TABLE EXCEEDED 
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■SEVERITY 1 

THE FOLLOHIMG SYHBOL IS SYNTACTICALLY ILLEGAL IN THE CONTEXT USED? 7? 
BBROB RICOVBRY HAY CAUSE SUBSEQUENT SPOBIOUS ERRORS 


•“3 ^ 
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ERROR MESSAGES FOR HAJQB CLASSIFICATION Q 

CLASSIFICATION "Q" ERBORS DEAL WITH SHAPING FUNCTIONS 

OA1 -SEVERITY 1 

ABRAYNES5 OF SINGLE ARGUMENT OF INTEGEB/SCALAR CONVERSION FUNCTION DOES ROT 
HATCH THAT OF EXPRESSION CONTAINING FUNCTION 

OA2 -SEVERITY 1 

ABRAYNESS OP RESULT OF INTEGER/SCALAB CONVERSION FUNCTION I6J UHCOH PUTABLE 
0A3 -SEVERITY 1 

SPECIFIED AREAYNESS OF INTEGER/SCALAB CONVERSION FUNCTION IS INCONSISTENT WITH 
NUMBER OP DATA ELEMENTS SUPPLIED IN ARGUMENT LIST 

0A4 -SEVERITY 1 

ARRAYNESS OF RESULT OF INTEGER/SCALAR CONVERSION FUNCTION DOES NOT HATCH THAT 
OF EXPRESSION CONTAINING PUNCTION 

0D1 -SEVERITY 1 

DIMENSIONS OF VECTOR/MATRIX CONVERSION FUNCTION DO NOT AGREE WITH THE NUMBER 
OF DATA ELEMENTS SUPPLIED IN THE ARGUMENT LIST 

OD2 -SEVERITY 1 

BIT OR CHARACTER CONVERSION FUNCTION HAY ONLY HAVE ONE ARGUMENT 

051 -SEVERITY 1 

COLONS AND SEMICOLONS MAY NOT APPEAR IN SUBSCRIPT OF CONVERSION FUNCTIONS 
0S10 -SEVERITY 1 

BIT OR CHARACTER CONVERSION PUNCTION HAY ONLY HAVE ONE SUBSCRIPT 
OS 11 -SEVERITY 1 

SUBBIT CONVERSION PUNCTION HAY ONLY HAVE ONE SUBSCBIPT 
OS 12 -SEVERITY 1 

COLONS AND SEMICOLONS HAY NOT APPEAR IN THE SUBSCRIPT OP A SUBBIT 
PSEUDO-VARIABLE 

0S13 -SEVERITY 1 

SUBSCRIPT OF A SUBBIT PSEUDO-VARIABLE HAY NOT CONTAIN A PRECISION 
MODIFIER 

052 -SEVERITY 1 

MATRIX CONVERSION FUNCTION DOES NOT HAVE TWO SUBSCRIPTS 

053 -SEVERITY 1 

VECTOR CONVERSION FUNCTION DOES NOT HAVE ONE SUBSCRIPT 

054 -SEVERITY 1 

INTEGER OR SCALAR CONVERSION FUNCTION HAS HORE THAN MAXIMUM PERMITTED 
NUMBER CP SUBSCRIPTS 

055 -SEVERITY 1 

SUBSCRIPT OP ARITHMETIC CONVERSION FUNCTION IS NOT A SINGLE INDEX 

056 -SEVERITY 1 

SUBSCRIPT OF ARITHMETIC CONVERSION FUNCTION KAY NOT CONTAIN » VALDES 

057 -SEVERITY 1 

SUBSCRIPT OF ARITHMETIC CONVERSION FUNCTION MUST BE AN USAHRAYED INTEGER/SCALAR 
EXPRESSION CONFUTABLE AT COMPILE TIME 
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058 

059 

0X1 

0X2 

0X3 

0X4 

0X5 

0X6 

0X7 

OXB 

0X9 


-SEVERITY 1 

VALUE Or SUBSCRIPT OP ARITHMETIC CONVERSION FUNCTION LIES OUTSIDE LEGAL RANGE 
—SEVERITY 1 

SUBSCRIPT OP BIT 08 CHARACTER CONVERSION FUNCTION HAY BOX CONTAIN A PRECISION 
QUALIFIER 

—SEVERITY 1 

CONVERSION FUNCTIONS HAY NOT HAVE ARGUHENTS OF STRUCTURE TYPE 
-SEVERITY 1 

HATFIX/VECTOR CONVERSION FUNCTIONS HAY NOT HAVE ARGUHENTS OF BIT TYPE 
—SEVERITY 1 

HATFIX/VECTOR CONVERSION FUNCTIONS HAY NOT HAVE ARGUMENTS 07 CHARACTER TYPE 
-SEVERITY 1 

MATRIX OR VECTOR ARGUMENT IS ILLEGAL IN BIT OR CHARACTER CONVERSION FUNCTION 
—SEVERITY 1 

CHARACTER CONVERSION FUNCTION WITH RADIX DOES NOT HAVE ARGUMENT OF BIT TYPE 
—SEVERITY 1 

BIT CONVERSION FUNCTION WITH RADIX DOES NOT HAVE ARGUMENT OF CHARACTER TYPE 
-SEVERITY 1 

IN AN ASSIGNMENT CONTEXT THE ARGUMENT OF A SUBBIT PSEUDO-VARIABLE MAY NOT 
ITSELF BE A SUBBIT PSEUDO-VARIABLE 

-SEVERITY 1 

ARGUMENT OF ILLEGAL TYPE IN SUBBIT PSEUDO-VARIABLE 
-SEVERITY 1 

THE ARGUMENT OF A SUBBIT PSEUDO-VARIABLE MAY NOT 
BE A NAME PSEUDO-FUNCTION. 
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EFROB MESSAGES FOB MAJOR CLASSIFICATION B 

CL ASSI PICA TICK "R" ERRORS ABE BELATED TO BEAL-TIHS STATEHEST EBROBS 

R 51 -SEVERITY 1 

ILLEGAL FORM OR VALUE OF ON EBBOR SUBSCRIPT 
RE2 -SEVERITY 1 

ILLEGAL PORN OB VALUE OF SEND ERROR SUBSCRIPT 

RB3 -SEVERITY 1 

TOO MANY ON ERROR STATEMENTS ACTIVE 

RT1 -SEVERITY 1 

SCHEDULE STATEMENT CONTAINS AN ILLEGAL FOBH OF VV TIMING EXPBSSSIOH 
BT1 0 -SEVERITY 1 

AN UNLATCHED EVENT HAY NOT BE SET OB BESET 
RT11 —SEVERITY 1 

USED IN A SEAL TIME STATEMENT OR AS A PROCESS EVENT, LABEL 
?? MAY NOT POSSESS ARRAYNESS. 

RTH -SEVERITY 1 

?? IS A MANE LABEL TYPE AND HAY NOT THEREFORE BE USED AS 
A PROCESS EVENT 

RT2 -SEVERITY 1 

WHILE EXPRESSION HAY NOT BE A TIMING EXPRESSION 
RT3 -SEVERITY 1 

SCHEDULE STATEMENT CONTAINS AH ILLEGAL FORM OF 7? EVENT EXPRESSION 
RTN -SEVERITY 1 

?7 STATEMENT CONTAINS ILLEGAL PRIORITY EXPRESSION 
RT5 -SEVERITY 1 

SCHEDULE STATEMENT CONTAINS DUPLICATED AT/IH/ON EXPRESSIONS 
R^B -SEVERITY 1 

WAIT STATEMENT CONTAINS ILLEGAL FORM OF ?7 EXPRESSION 
R?7 -SEVERITY 1 

EVENT MUST BE SIGNALLED ON/OFF OR ITS BINARY EQUIVALENT 

RT8 -SEVERITY 1 

AN ARRAYED EVENT HAY NOT BE SIGNALLED 

RT9 -SEVERITY 1 

USED IN A HEAL TIME STATEMENT OR AS A PROCESS EVENT, LABEL 
77 MUST BE A PROGRAM OR TASK, 

RU1 -SEVERITY 1 

SIGNAL STATEMENTS ARE THE ONLY REAL-TIME STATEMENTS WHICH HAY APPEAR INSIDE 
AN UPDATE BLOCK 
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error messagzs for major classification s 

CLASSIFICATION "S w ERRORS INDICATE INCORRECT SUBSCRIPT OSAGE 


SCI -SEVERITY 1 

?? HAS TOO MANY STRUCTURE SUBSCRIPTS 

SC2 -SEVERITY 1 

?? HAS TOO HANY ARRAY SUBSCRIPTS 

SC3 -SEVERITY 1 

?? HAS TOO FEN ARRAY SUBSCRIPTS 

SC4 -SEVERITY 1 

?? HAS TOO HANY COMPONENT SUBSCRIPTS 

SC5 -SEVERITY 1 

?? HAS TOO FEN COMPONENT SUBSCRIPTS 

S PI -SEVERITY 1 

SUBSCRIPTING CONTAINS MORE THAN ONE LIST OF STRUCTURE SUBSCRIPTS 


SP2 -SEVERITY 1 

SUBSCRIPTING CONTAINS MORE THAN ONE LIST 07 ARRAY SUBSCRIPTS 


SP3 -SEVERITY 1 

SUBSCRIPT CONTAINS LEADING COLON, OR A COLON PRECEDED BY A SEMICOLON, 

COLON, OR COMMA 

SP4 -SEVERITY 1 

SUBSCRIPT CONTAINS LEADING SEMICOLON, OR A SEMICOLON PRECEDED BY A SEMICOLON, 
COLON, CR COMMA 

SP5 -SEVERITY 1 

SUBSCRIPT CONTAINS A LEADING COMMA, OR A COMMA PRECEDED BY A SEMICOLON, COLON, 
OR COMMA 

SP6 —SEVERITY 1 

SUBSCRIPT IS EHPTY OB CONTAINS A TRAILING COMMA 
SOI -SEVERITY 1 

?? IS OF INCORRECT TYPE TO POSSESS A PRECISION QUALIFIER 


SQ2 -SEVERITY 1 

SUBSCRIPTED VARIABLE ?? HAY NOT POSSESS A PRECISION MODIFIER 


SQ3 -SEVERITY 1 

?? IS IN AN ASSIGNMENT CONTEXT AND THEREFORE MAY NOT POSSESS A 

PRECISION QUALIFIER 

SRI -SEVERITY 1 

SIZE OF PARTITION IN A SUBSCRIPT OP ?? HAS UNKNOWN 
SR2 -SEVERITY 1 

SIZE OF PARTITION IN SUBSCRIPT OF ?? IS EITHER LESS THAN 2 OR 
PRODUCED AN INDEX VALUE GREATER THAN THE MAXIMUM ALLOWABLE 


5R3 —SEVERITY 1 

THE VALUE OF A SUBSCRIPT OF ?? HAS GREATER THAN THE CORRESPONDING DIMENSION 
SR4 -SEVERITY 1 

THE VALUE OF A SUBSCRIPT OF ?? HAS LESS THAN 1 
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Sl|5 -SEVERITY 1 

?? CO STAINED AH ILLEGAL t SUBSCRIPT 

SF6 -SEVERITY 1 

INDEX VALUE IN SUBSCRIPT OP’ ?? IS UNKNOWN 
3S1 -SEVERITY 1 

IN SUBSCRIPT OF 7? ONLY TRAILING ASTERISKS HAY BE OHITTED 
ST1 -SEVERITY 1 

A SUBSCRIPT OP 77 WAS NOT OP INTEGER OR SCALAR TYPE 
S VI ^SEVERITY 1 

SUBSCRIPTING OP 77 IS ILLEGAL IN CONTEXT OP USE AS AN ASSIGN ARGUHENT 
SV2 -SEVERITY 0 

USSR SUPPLIED OVERRUNCH NOT CONSISTENT WITH SUBSCRIPTING FOR VARIABLE. 77 

SV} ^SEVERITY 1 

77 HAY NOT POSSESS SUBSCRIPTS 
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ERROR INPUT/OUTPUT STATENENTS 

:1 'HotShT ip I/O CONTROL FUNCTION DUST BE OF UNAPPLIED INTEGER 08 SCALAR TIPE 

” *!% E CIvicE NONBER IS NOT IN RANGE 0 THROUGH 11 

52 'recorTaodress IS NOT AN UNARRAIED INTEGER OR SCALAR 

' "v API AELE IN READALL IS NOT OF CHARACTER TIPE 

1 .eg VF RI TY 1 

2 VASIAELE IN BEAD KAY NOT BE OP EVENT TYPE 


TaMAbIe IN READ/READALL HAI NOT BE a SUBBIT PSEUDO-VARIABLE 
‘f Fui T STATEHENT HAI NOT READ INTO A SUBBIT PSEUDO-VARIABLE 


T5 


T6 


T7 


” AN. T/O^ STATEMENT HAI NOT CONTAIN A NAHE PSEUDO-FUNCTION 
OB NULL. 


T/i E s”iESENT CONTAINS A STRUCTUPB HHOSE TEMPLATE CONTAINS 
AT LEAST ONE TERMINAL NODE WITH THE NAHE ATBIBUTE, 


■SEVERITY 1 

IN PILE STATEHENT VARIABLE TO BE BEAD POSSESSES 
AN ILLEGAL SUBSCBIPT. 


T8 


-SEVERITY 1 

IN FILE STATEHENT VARIABLE TO BE 
POSSESS HOLTIPIE COPIES IP IT IS 
NAHE, 

I 


BEAD INTO HAY ONLY 
A HAJOB STRUCTURE 
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ERROR MESSAGES FOB MAJOR CLASSIFICATION 0 

CLASSIFICATION "0” EBBORS DEAL RITH UPDATE BLOCKS 

UI1 -SEVERITY 1 

?? IS LOCKED: IT KAY ONLY APPEAR IN UPDATE BLOCKS 
OR ASSIGN ARGUMENT LISTS, 

UI2 -SEVERITY 1 

UPDATE BLOCK DEFINITION MAY NOT APPEAR INSIDE AN UPDATE BLOCK 
yPI -SEVERITY 1 

THE PROCEDURE, TASK, OR PROGRAM 7? MAY NOT BE INVOKED MITHIN THE 
CURRENT UPDATE BLOCK 

UP2 -SEVERITY 1 

UPDATE BLOCKS MAY NO^ CONTAIN RETURN STATEMENTS 
UP3 -SEVERITY 1 

THE FUNCTION ?? HAY NOT BE INVOKED WITHIN THE CURRENT UPDATE BLOCK 
UT1 -SEVERITY 1 

I/O STATEMENTS ABE ILLEGAL INSIDE UPDATE BLOCKS 
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ERROR MESSAGES FOR MAJOR CLASSIFICATION V 

CLASSIFICATION "V" ERRORS ABE RELATED TO COMPILE-TIME VARIABLE ERRORS 

V A 1 • -SEVERITY 1 

COHPIIE TIME INTEGER/SCALAB -ADDITION FAILED 
VA2 -SEVERITY 1 

COMPI IE-TIME INTEGER/SCALAR SUBTRACTION FAILED 

V A3 -SEVERITY 1 

COMPILE TIME INTEGER/SCALAR MULTIPLICATION FAILED 
VA4 -SEVERITY 1 

COMPILE-TIME INTEGER/SCALAB DIVISION PAILED 

V AS -SEVERITY 1 

COMPILE TIME INTEGER/SCALAB EXPONENTIATION PAILED 
VC1 -SEVERITY 0 

COMPILE-TIME CATENATION PRODUCED TOO LONG A CHARACTER STRING - 
TRUNCATED TO 255 CHARACTERS 

VE1 -SEVERITY 1 

AN EXPRESSION NOT COMPUTABLE AT COMPILE-TIME HAS BEEN USED IN A CONTEXT WHERE 
A VALCE MUST BE KNOWN 

VF1 -SEVERITY 1 

' COMPILE-TIME EVALUATION OF ?? FUNCTION FAILED 
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ERROR 

XA1 

X A2 
XA3 
XD1 

m 

XD3 

XD4 

XII 

XJ? ' 

XI3 

XUt 

XVI 


MESSAGES FOB MAJOR CLASSIFICATION X 
CLASSIFICATION "X* ERRORS DEAL V ITH 


I MPLS NX STATION DEPENDENT FEATURES 


ONLINE PROGRAM IDENTIFICATION DIRECTIVE IS ALLOWED IN A COMPILATION 
UNIT. 

SEVERITY 0 

THE PROGRAM IDENTIFICATION DIRECTIVE DOES NOT CONTAIN A VALID IDENTIFICATION. 
THE DIRECTIVE MTtS^ BE OF THE FORM: 

D EFOGRAH ID*<ID> 


^SEVERITY 0 

A PROG FAN IDENTIFICATION DIRECTIVE BUST APPEAR FOLLOWING ANY EXTERNAL 
TEMPLATES AND FFIOR TO THE BEGINNING OF THE PRIHARY UNIT OF COHPILATION. 
THE CURFENT directive IS out OF place AND will not be PROCESSED. 


•SEVERITY 0 

UNINTELLIGIBLE INFORMATION IN DEVICE DIRECTIVE 


^SEV ER ITY 0 

DUPLICATE DEVICE DIRECTIVE FOB CHANNEL 7? 

-SEVERITY 0 

DEVICE DIRECTIVE DOES NOT CONTAIN A VALID CHANNEL INDICATION 


-SEVERITY 0 

CHANNEL NUMBERS MUST BE IN RANGE 0 TO 9 
-SEVERITY 0 

NESTED INCLUDE DIRECTIVES NOT ALLOWED 
-SEVERITY 0 

INCLUDE DIRECTIVE DOES NOT CONTAIN A NAME 
-SEVERITY 0 

?? tfOT IN INCLUDE LIBRARY 
•SEVERITY 0 

D CMP CONTAINS UNKNOWN DIRECTIVE 
•SEVERITY 1 

LAST LINS OF TEMPLATE LIBRARY MEMBER ?? IS NOT A VALID 
VERSION DIRECTIVE 
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PHASE II ERRORS 


Compiler Limits 


SEVERITY 2 

DATA STORAGE CAPACITY EXCEEDED 
SEVERITY 2 

INDIRECT STACK OVERFLOW 
SEVERITY 2 

CHARACTER LITERAL BUFFER OVERFLOW 
SEVERITY 2 

CONSTANT TABLE OVERFLOW 
SEVERITY 1 

TOO MANY EXTERNAL NAMES 
SEVERITY 1 

STORAGE DESCRIPTOR STACK OVERFLOW 
SEVERITY 1 

EXCEEDED TEMPORARY SPACE 
SEVERITY 2 

STATEMENT LABELS ALL IN USE 
SEVERITY 2 

SUBPROGRAM STACK OVERFLOW 
SEVERITY 1 

EXCEEDED ON ERROR STACK SIZE 
SEVERITY 1 

TOO MANY UNIQUE OPERANDS IN EVENT EXPRESSION 
SEVERITY 1 

EXCEEDED ARGUMENT STACK SIZE 
SEVERITY 1 

EXCEEDED SHAPING FUNCTION DIM STACK 
SEVERITY 1 

EVENT EXPRESSION -TOO LONG 
SEVERITY 1 

FLOW LABEL TABLE OVERFLOW 
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User Errors 


SEVERITY 1 

SIZE CONFLICT ON VECTOR/MATRIX PARAMETER #N 
SEVERITY 1 

ASSIGN PARAMETER NOT SYMBOL 
SEVERITY 1 

DATA TYPE CONFLICT ON PARAMETER #N 
SEVERITY 1 

ARRAYNESS CONFLICT ON PARAMETER #H 
SEVERITY 1 

ARRAY SIZE CONFLICT ON PARAMETER #H 
SEVERITY 1 

, NOT AS’SIGN PARARMETER 
SEVERITY 1 

STATEMENT CONTAINS PHASE I ERROR 
SEVERITY 1 

UNIMPLEMENTEP FEATURE OF HAL/S CALLED FOR 
SEVERITY 1 

MALFORMED TEMPLATE, WALK INHIBITED 
SEVERITY. 1 

STRUCTURE TEMPLATES DO NOT J1ATCH 
SEVERITY 1 

STAR SIZE ARRAY TEMPORARY NOT ALLOWED 
SEVERITY 1 

STRUCTURE COPYNESS CONFLICT Off PARAMETER #N 
SEVERITY 1 

STRUCTURE COPY SIZE CONFLICT QN PARAMETER #N 
SEVERITY 1 

REFERENCE TO UNDEFINED PROCEDURE OR FUNCTION 
SEVERITY 1 

INCORRECT NUMBER OF ARGUMENTS TO ?? 

SEVERITY 1 

...ILLEGAL UPUHAL FUNCTION TYPE._ 
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SEVERITY 1 

DO FOR ENDING INCOMPLETE DUE TO PREVIOUS ERROR RECOVERY 

SEVERITY 1 
ARRAYNESS CONFLICT 

SEVERITY 1 
COPYNESS CONFLICT 

SEVERITY 1 

ARRAYNESS INCINSISTENT WITH STATEMENT 
SEVERITY 1 

NON-ARRAYED ARGUMENT TO ARRAY FUNCTION 
SEVERITY 1 

INVALID ARGUMENT TYPE FOR ARRAY FUNCTION 
SEVERITY 1 

ILLEGAL ARGUMENT' TO SIZE FUNCTION 
SEVERITY 0 

INITIAL STRING TOO LONG 
SEVERITY 0 

INITIAL VALUE TOO LARGE 
SEVERITY 1 GQ 

INITIALIZATION DATA TYPE MISMATCH 
SEVERITY 1 

NULL ONLY LEGAL NAME CONSTANT 
SEVERITY 1 

ILLEGAL NAME PARAMETER #11 
SEVERITY 1 

NAME PROCEDURE/FUNCTION MAY NOT HAVE ARGUMENTS 

SEVERITY 1 

NOT NAME PARAMETER 

SEVERITY 0 

TEMPORARY ?? NOT ADDRESSABLE 

SEVERITY 0 * 

?? NOT ADDRESSABLE 

SEVERITY 1 

SUBBIT SUBSCRIPT OUT OF RANGE ' ' 

SEVERITY 1 

CANNOT RETURN VALUE FROM NON-FUNCTION 


D-40 

INTERMETRICS INCORPORATED • 701 CONCORD AVENUE * CAMBRIDGE, MASSACHUSETTS 02138 • (617) 661-1840 



Compiler Errors 


SEVERITY 1 

LITERAL PROCESSING FAILURE 
SEVERITY 0 

INDEX STACK USAGE INCONSISTENT 
SEVERITY 0 

UNMATCHED DO CASE ENDING 
SEVERITY 0 

UNMATCHED CASE LABEL 
SEVERITY 0 

UNMATCHED DO WHILE ENDING 
SEVERITY 0 

UNMATCHED DO FOR ENDING 
SEVERITY 1 

LEVEL MISMATCH ON PROC/FUNC/IO ARGUMENT 
SEVERITY 1 

LEVEL MISMATCH ON SHAPING FUNCTION ARGUMENT 
SEVERITY 1 

STRUCTURE NODE SIZp CONFLICT 
SEVERITY 1 

ARRAY LEVEL MISMATCH 
SEVERITY 1 

ARRAY ENDING MISMATCH 

SEVERITY 1 1 
MISMATCHED CLOSING 

SEVERITY 1 

LEVEL MISMATCH ON PROC/FUNC CALL 
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APPENDIX E. 


Execution-time Errors 


The following tables indicate runtime error conditions which 
may occur during execution of a HAL/S-360 program. The tables 
list any standard fixups performed by the runtime system® The 
form of the system action taken is indicated by the following 
code: 


U UNLIMITED 

L LIMITED 

T TERMINATE 



< 
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Explanation 

Standard Fixup 

i 

the exponent of a scalar 
or of a vector /matrix 
element has overflowed 

the result is set 
to the maximum 
value representable 
on the machine 

the exponent of a scalar 
or of a vector/matrix 
element has underflowed 

the result is set 
to zero 

a scalar division by 
zero has occurred 

the result is set 
to the maximum 
value representable 
on the machine 

a negative or zero 
power was specified 

the result is set 
to zero 
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Error 

Number 

Message 

6 

EXP FUNCTION HAS ARG > 174.673 


is 


w 

I 

LJ 


10 


LOG FUNCTION HAS ARG < * 0 


SIN OR COS FUNCTION HAS 


, ,,f2.62lE5 ) 

{ 1.126E15 f 


PI 


SIN OR COSH FUNCTION HAS 
ARG > 175,366 


ARCS IN OR ARCCOS FUNCTION HAS 

|arg| > 1 


Explanation 


Standard Fixup 


the result is set to 

* the maximum value 

representable on the 
machine 


if the argument was 
zero then the result 
is act tu me maxi- 
mum representable 
negative value, else 
it is set to the log 
,o c the absolute value 
of the arg. 


the two figures are for 
single and double pre- 
cision arguments 
respectively 


the result is set 
to 



2 


the result is set to 
the maximum value 
representable 


the result is set 
zero 
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I 


Error 

Number 

Message 

11 

TAN FUNCTION HAS 
|arg| > 

; 

12 

TAN FUNCTION TOO CLOSE TO 
SINGULARITY 

13 

CASE VARIABLE OUT OF RANGE 

14 

CLOSE REACHED ON 
FUNCTION 

i 

15 

SCALAR TOO LARGE FOR INTEGER 
CONVERSION 


Explanation 


the two figures are -Eor 
single and double preci- 
sion respectively 


Standard Fixup 


the result is set 
to one 




the argument is too closf the result is set t< 
to an odd multiple of the maximum repre- 
tt/ 2 sentable value 


the value of the case the do case state- 
variable is either <1 or ment is ignored 
greater than the number 
of cases and there was 
no ELSE clause 




no return statement was 
encountered prior to 
reaching the close of th< 
function 


none j IGNORE not 
allowed 




the result is set 
to the maximum 
representable value 
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Error 

Number 



16 INTEGER DIVISION BY ZERO 



ILLEGAL CHARACTER SUBSCRIPT 



BAD LENGTH IN LJUST OR RJUST 



MOD DOMAIN ERROR 


CHARACTER TO SCALAR CONVERSION 


Explanation _ 

[ ' 

Standard Fixup 

DIV OPERATOR HAS ZERO 

'divisor 

The result is set 
to the maximum 
representable 
value 

Character component 
subscripting out-of- 
bounds 

The out-of-bounds 
subscript (s) set 
to first or last 
character 

The length is less 
i than the string length 

. 

. 

■ 

Truncation to the 
specified length 
occurs on the left 
(RJUST) or right 
(LJUST) 

In A mod B 
B=0 and A<0 

Returns A 
(negative) 

The string was not in 
standard internal 
format for integers. or 
scalars. 

The result is 
zero. 
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Error 

Number 




CHARACTER TO SCALAR 
CONVERSION DURING INPUT 



CHARACTER TO INTEGER 
CONVERSION 




CHARACTER TO INTEGER 
CONVERSION DURING INPUT 


NEGATIVE BASE IN 


EXPONENTIATION 


VECTOR/MATRIX DIVISION 


BY ZERO 


Explanation 

t 

Standard Fixup 

Same as above. 

The variable is 
left unchanged. 

The string was not in 
standard internal 
format for integers 

The result is zero. 

Same as above. 

The variable is 
left unchanged 

A**B where A<0 

/ The result is 
| a| **b 


The result is 
the original 
vector/matrix 
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— 

Error 

Number 

■ 3 r 

MESSAGE 


' 

26 

ILLEGAL BIT STRING 



DURING INPUT 

05 

27 

ARG OF INVERSE IS SINGULAR 




A 



M 



1 




28 

ARG OF UNIT FUNCTION IS. 



NULL VECTOR 


— 

29 

ILLEGAL BIT STRING 

30 

Illegal SUBBIT subscript 


EXPLANATION 


STANDARD FIXUP 


Character other than 


Variables left 


blank, zeros or ones 


unchanged 


The result is the 
identity matrix 


Every component of the 
vector was zero in 
value o 


The result is a 
vector all of whose 
components is zero. 


Returns 


zero 


value of routine 
SUBBIT subscript 
exceeded bit length 


Subscript takes 
value of exceeded 
limit 
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Error 

Number 



SYNAD ERROR: xxx 


MISSING DD CARD - XXX 



PRINT ON INPUT CHANNEL N 
or 

INPUT ON. PRINT CHANNEL N 


ILLEGAL SKIP COUNT ON CHANNEL I 


MARGIN VIOLATION ON CHANNEL n 


t 


Explanation 


Standard Fixup 


SYSTEM 

Action 



* 



— 

A transmission error 
was detected in a REAEJ 
RE AD ALL , or FILE stmnt. 
SYNAD message "xxx" 
describe s the e r ror . 

The block is 
accepted as is 
(ERROPT-ACC) 

L 


User did not provide 
the specified CHANNELn 
or FILEn DD card. 

I/O on the channel 
is ignored 

T 


I/O was attempted on 
specified channel in 
print mode as well as 
read/readall mode. 

The channel remains 
in the original 
mode, I/O in the 
new mode is ignored. 

T 

1 

The number of skips 
is negative. 

Skip (0) is assumed 

L 


A TAB or COLUMN I/O 
control function was 
specified which forced 
the device mechanism 
off the left or right 
margin. 

The horizontal posi- 
tion is reset to eiti 
column one (left 
margin error) or just 
off the right-hand 
margin. On an I/O 
transfer this latter 
causes an immediate 
skip to the next line 

er 

L 

• 
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m 

x 

S 

tn 

— t 

x 

o 

<z> 


H 

I 

VO 

<39 

G3 

A 


B 11 

Error 

Number 

< 

Message 

Explanation 

Standard Fixup 

m 

36 

ILLEGAL PAGE COUNT ON CHANNEL n 

A PAGE I/O control func- 
tion with negative argu- 
ment was specified 

The PAGE command is 
ignored . 

L 

37 

ILLEGAL LINE COUNT ON CHANNEL n 

In a LINE I/O control 
function on an "unpaged" 
channel an argument less 
than the current line 
number was specified, or 
in the case of print mode 
a value areater than the 

number of lines per page 
was specified. 

In the first case the 
LINE function is 
ignored. In the 
second, the effect if 
PAGE (1) . 

L 

38 

ILLEGAL NUMERIC FIELD ON 
CHANNEL n 

An invalid character was 
found while reading a 
numeric field (Valid 
characters: 0-9, - , +, 

E» B, H) 

The field with the 
invalid character (s) 
is skipped. The var- 
iable remains unchanc 
as if a null _f ield 

were encountered. 

L 

ed 

39 

ILLEGAL BIT OR CHARACTER STRING 

In READ mode, character/ 
bit strings must be 
delimited by apostrophes, 
with included apostrophes 
doubled. 

The field is treated 
as a numeric field 
with regard to sepa- 
rators , and is 
skipped. The charac- 
ter/bit variable re- 
mains unchanged as if 
a null field were 
encountered . 

L 
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03 


td 

l 


Error 

Number 

« 

Message 

40 

through 

49 

END OF FILE ON CHANNEL n 

50 

ERROR IN HAL SOURCE 

51 

PROCESS NOT SCHEDULED DUE TO 
UNTIL/WHIIE: program or task 

name 

52 

PRIORITY NOT UPDATED, PROCESS 
NOT ON QUEUE: program or task 

name 

| ' 

53 

PROCESS NOT TERMINATED: NOT 

ON QUEUE: program or task name 


Explanation 


Standard Fixup 


t 

Error 40+n is signalled 
if the end of file is 
reached while reading on 
channel n. 


The remainder of the 
I/O statement is 
ignored. A further 
read on that channel 
will close and reope 
the file at line 1 


again . 


Continue 


A SCHEDULE statement with 
the UNTIL <arith exp> or 
KHILE <event exp> was 
executed, and the time was 
already passed, or the 
event expression was false 


The SCHEDULE statementl 
is ignored. I 


The specified task or 
program is not a 
currently scheduled 


The update request 
is ignored. 


process . 


Same as above 


The terminate 
request is ignored 
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o 

A 


1 

Message 


54 

PROCESS NOT CANCELLED, NOT 
ON QUEUE: program or task name 

55 

i 

| 

PROCESS NOT SCHEDULED - 

ALREADY ACTIVE: program or task 

name 

56 

PROCESS DEADLOCK 

57 

"REPEAT EVERY" P ro 9 ram or task 
OVERLAP ; name 

S > 

53 

PROCESS NOT TERMINATED: NOT A 

DEPENDENT: program or task name 


Error 

Number 


Explanation 


* Standard Fixup 


Same as above. 


The specified program 
or task is currently 
an active process 


All remaining processes 
are in a wait state for 
some condition other 
than time. 


The process was scheduled 
with the REPEAT EVERY 
option, and the current 
cycle lasted longer than 
the EVERY value. 


The specified program or 
task is not dependent on 
the running process/ 


The cancel request 
is ignored. 


The SCHEDULE 
statement is 
ignored . 


None (IGNORE or G0T< 
action not allowed) 


(GOTO ACTION not 
allowed) 

The cycle which was 
supposed to start is 
skipped . The timing 
stays "in phase". 


The terminate* 
request is ignored. 
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£0 

A 


Error 

Number 

! 

Message 

59 

ARCCOSH function has argument < 1 

60 

ARCTANH function has |arg| > 1 

61 

ARCCOTH function has |arg| < 1 

62 

BITOOCT - INVALID character 

■ 

63 

BIT0HEX - INVALID character 

64 

No Space in File 


I 




Attempt to add a 
new block to Type II 
or III file failed. 


Return 0 j L 

Return 0 I L 


The I/O operation 
is ignored. 
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td 

H* 

U> 

K 

m 

& 

A 



Explanation 


Standard 

Fixup 


Block in memory and 
block on file indic- 
ated by FILE stinnt 
have different lengths 

See Sec. 7 

Block number speci- 
fied in FILE stmnt 
is out of legal 
range for partitioned 
file 

The I/O 
operation 
is ignored 



Error 70+n is signalled 
led if a Type II or III 
file input request indi- 
cates a legal but non- 
existent block. 

The I/O 
operation 
is ignored 













APPENDIX P 


USEF ABEND CODES 


User Abend Codes Durinq Execution 


0 Missinq DD card for message channel. The HAL/S 
channel specified for vritinq error and trace 
aessaqes had no assigned DD card. (This may also 
appear as SYSTEM ABEND CODE D) . 

1 RAL/S error with SYSTEM=T, A run time error 

* causinq abnormal termination occurred. A specific 

message preceding the ABEND information explains 

the error. 

2 HAL. S error with 5 YSTEM=L and error count exceeded. 

A run time error occurred and the specified maximum 

error count for that error was thereby exceeded. 

3 Invalid error recursion. An error condition arose 

while processing a run time error. 

4 unused 

5 unused 

6 I/O mode conflict. Input asked for when I/O 

processor expected output or vice versa D 

7 Illegal I/O channel or mode. I/O asked for on 

illegal channel, or I/O mode was Illegal. 


9 Program interrupt in non-HAL/S environment. 



Fegisters 12, 15 

interrupt. 

not set as expected on 

program 

10 

Proqram interrupt 
instruction. 

from convert-to-binary 

(CVB) 

11 

Illegal HAL/S error 

number. 


12 

Too many events in 

event expression £>6} 


13 

Invalid event expression 






Ds«r Abend Codes During Compilation 


100 

200 

300 

400 

500 

600 

700 

800 

900 

1000 

1100 

1200 

1300 

1400 

1500 

1600 

1700 

1800 

1900 

2000 

2100 

2200 

2300 


Unable to open one of the files: PROGRAM, 

5YSIN, or SYSPRINT 

Unexpected end of file while reading in the XPL 
proqran 

Synad error while reading in the XPL prograa 

XPL prograa won’t fit in the aaount of memory 
available 

Invalid service code fro* the XPL progra* 
Printed-page limit exceeded 

Linked programs specified different size common 
areas 

Synad error on output file 
Invalid output file specified 
Synad error on input file 

Linkinq process overlayed comaon string area 

End of file error on input file 

Inpossible to move the common strings up during 
linking 

Invalid input file specified 

Unknown request by ’MONITOR* func 

Unknown do in ’MONITOR 1 request 

Directory error on PDS 

Synad error on output PDS file 

Invalid neaber nane specified 

Synad error on direct access file 

Attempt to read fron an input PDS without 
issuing the "FIND" HONITOR reguest first 

End of file error on direct access file 

Invalid aeaber to be found 


F-2 





2400 


2500 

3000 

4000 


Synad error on PDS input file 

File blocking specification error 

«ON#9/10 error or aisaligned 15 

XPL program called exit to force an abend (and a 
possible core duap) 


1S'3< 
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APPENDIX G 


List of HAL/S-360 runtime library routines. 

These names should not be used to name any user-written, NONHAL 
routines . 


ARCCOS ALIAS(ARCSIN) 

ARCSINH ALIAS (ARCCOSH) 

ARCTAN 

ARCTANH ALIAS (ARCCOTH) 

BAKTRACE 

BIN ALIAS ( CTOB ) 

BOUT ALIAS(BTOC) 

CANCEL ALIAS(CANCELT) 

CINDEX 

CINP 

CLJUSTV 

CLOKTIME 

CLOSEHAL 

COLUMN ALIAS ( TAB ) 

• COUTP 
CPAS 
CPASP 
CRJUSTV 
CSHAPQ 

CSLD ALIAS ( CPSLD , CPSLDP , CPSST , CPSSTP , CSLDP , 

CSST , CSSTP ) 

CTOX ALIAS ( CTOO ) 

CTRIMV 

DARCCOS ALIAS(DARCSIN) 

DARCSINH ALIAS (DARCCOSH) 

DARCTAN 

DARCTANH ALIAS(DARCCOTH) 

DATE 

DEXP 

DISPATCH ALI AS ( DISPACHS , DISPACHT , DISPACHW ) 

DLOG 

DSIN ALI AS ( DCOS ) 

DSINH ALIAS(DCOSH) 

DSLD ALIAS ( DSST } 

DSQRT 

DTAN 

DTANH 

DTOTHED 

EIN ALIAS (CTOD , CTOE , DIN) 

EOUT AL I AS ( DOUT , DTOC , ETOC ) 

ERRORMON 

ERRORSUM 

ERRTAB 

ETOTHEE 

EVENTENQ ALIAS(EVENTPRO) 

EXCLUDE ALIASC ALLOW) 

136 < 
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EXECTRCE 

EXP 

FINDFIX ALIAS(GETADDR,GET$IZE) 
GETPTR 

HALDUMP ALIAS ( HSLOCATE ) 

HALSIM 

HALSTART 

HALSYS 


HDREAD AL IAS( HDOPEN , HD WRITE ) 

HSDUMP 

IIN ALIAS (CTOI.CTOK, BIN) 

INPUT ALIAS ( Cl N , SKI PIN) 

IOINIT ALIAS (MSGIOINT) 

IOUT ALIAS(ITOC) 

ITOTHEI ALIAS(DTOTHEI ,ETOTHEI) 

LINE 

LOG 

MM6DN 

MM6D3 

MM6SN 

’MH6S3 

MOHSTACK 

MV6DN 

MV6SN 

M1DNP 

M1DSNP 

M1SDNP 

M1SNP 

M11DN 

M11SN 

M12DN 

Ml 2D 3 ALIAS (Ml 4D3 ) 

M12SN 

M12S3 ALIAS (Ml 4S3) 

M13DN 

H13D3 

M13SN 

Ml 333 

Ml 4DN 

M14SN 

M15DN 

M15SN 

M16DNP 

M16SNP 

M17DN 

M17SN 

M20DNP 

M20SNP 

M21DNP 

M21SNP 

NDX2PTR 

OUTPUT ALIAS ( CO UT , FLUSH , HALPRINT , SKI POUT ) 


G-2 
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PAGE 

PAGER ALIAS(FILETAB , NUMOFFLS f NUMOFPGS , PAGETAB) 

PROGINT 

QSHAPQ 

RANDOM ALIAS(GETSEED,RANDOMG,SETSEED) 

READBUFF ALIAS ( CMPLBIT) 

READPAGE ALIAS ( PDSFILE) 

SCHEDULE 

SDLDUMMY ALIAS ( SDATRAP , SDETRAP , SDFTRAP , SDINIT , SDNTRAP , 
SDSTRAP , SDTTRAP , SDWTRAP ) 

SDLSTACK 

SET ALIAS ( RESET ) 

SIGNAL 

SIN ALIAS ( COS) 

5IlWr~ALIAS(CbSHj 

SKIP 

SQRT 

STMTRACE 
SVBTOC 
SVDTOC 
SVETOC 
SVITOC 
.SVPMSG 
SVS TOP 
SVTDEQ 
SVTENQ 
SVTIME 
SYMBFILL 
TAN 
TANH 
TENSTBL 
TERMIN 
TERMINT 
TERMPCB 

TIMENQ ALIAS ( TIMECANC , TIME I NT) 

UPPRIO ALIAS (UPPRIOT) 

VM6DN 

VM6SN 

V06DN ALIAS ( V06D3 ) 

V06SN ALIAS(V06S3) 

VV6DN 

VV6SN 

V16DNP 

V16SNP 

V9D3 ALI AS ( V 10DN , V 1 OD3 , V9DN ) 

V9S3 ALIAS (V10SN,V10S3,V9SN) 

WAIT ALIAS(WAITUNTL) 

WAITDEP 

WAITFOR 

WHERE ALIAS( WHERES , WHERESP) 

XTOC ALIAS ( KTOC f OTOC ) 
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APPENDIX H 


Compiler Directives 

The following compiler directives have been defined for the 
H At/S -3 60 compiler* 


a) The DEVICE directive has the form: 

D DEVICE CHA NNEL= n <option> 

This directive sets the mode of the specified channel 
(referred to via the CHANNELn DD card) to the mode 
indicated by the <option>. The <option> may be "PAGED", 
"UNPAGED", or null (in which case UNPAGED is assumed)* 

b) The INCLUDE directive has the form: 

D INCLUDE <name> <option> 

This directive names a member of an include library as 
defined in section 6*2*7* The <option> may be "NOLIST" or 
null* The "NOLIST" option indicates that the included 
text is not to be listed. 


c) The PIOGIIH directive has the fore: 

D PROGRAM ID«<id> 

This directive provides a Program Identification Name to be 
used by the compiler to determine access rights to controlled 
resources as described in Section 6* 2* 8* 


H-i 1S9< 
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APPENDIX I 


The HALLINK Program 


The HAL/S- 36 O compiler system employs a mechanism for the 
handling of temporary work areas at execution time which 
requires special processing at the time all pieces of a run are 
linked together. This processing is achieved by substituting a 
HAL/S-360 compiler system routine for the standard OS/ 36 O link 
editor in the LINKED step in the program generation process. 

This program is known as HALLINK. 

Temporary work areas and general register save areas used 
by a -running HAL/S program are obtained from an area called the 
' STACK. The STACK is really a CSECT of sufficient size to allow 
all routines with temporary data requirements to obtain memory 
from the STACK csect. One STACK CSECT exists for each PROGRAM 
or TASK in a program complex. It is not until link-edit time 
that all of the individual routines' requirements for temporary 
space are known. The HALLINK program determines the 

requirements and creates the STACK for each PROGRAM and/or 
TASK. In performing this function, HALLINK makes use of the 

standard OS/360 linkage editor. The HALLINK program has been 
designed to be essentially transparent to the user (i.e, it 
performs functionally the same task as the standard 

link-editor). Persons using the standard JCL procedures listed 
in Appendix C need not be concerned with the existance of the 
HALLINK step. 

The processing done in HALLINK is generally broken down 
into three phases: 

1) Invoke the standard linkage editor thus 

performing all library searches and producing a 
load module with references to the STACK csects 
unresolved. This load module is written to the 
TEMPLOAD DD card. 

2) Analyze the load module which was put on the 

TEMPLOAD DD card and create the necessary 

control sections as object files on the 

STACKOBJ DD card. 

3) Re-invoke the standard linkage editor to 
incorporate the STACK csects into a final load 
module which is placed on the SYSLMOD DD card. 

£O0< 
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Some special considerations may arise when attempting to use 
features of the OS/36O linkage editor in the HALLINK step. A 
few comments on certain of these features follow: 


a) Provision has been made to pass load module name 
information to the second link edit step if a 
NAME card was sent by the user to the first 
link edit. If the member name on the TEMPLOAD 
load module is not TEMPNAME t the second link 
edit step is passed the record: 

NAME XXXXXXXX ( R ) 

as part of the generated object decks. The 
TEMPLOAD member name is determined by the first 
name found in the directory of that PDS. If 
the member name was TEMPNAME, no such card will 
be passed to the second link edit, and it is 
the user's responsibility to ensure that a name 
is specified on the SYSLMOD DD card, otherwise 
the link editor will attempt to store the load 
module as TEMPNAME, 


The user should be fully aware of the 
consequences of supplying a NAME card without 
overriding the member name on the catalogued 
SYSLMOD DD card. This situation will lead to 
JCL errors if the GO step attempts to use 
refer-back ( PGM = * . LfCED , SYSLMOD) to identify the 
module to be executed, 

b) The overlay capabilities of the Linkage Editor 
should not be used. 


The following topics describe the various input options 
and ouput return codes produced by HALLINK, 

HALLINK Output 

HALLINK produces a series of object decks and directives 
to th® Link Editor, They are described in the sequence 
that they are generated. User-control of HALLINK action is 
described later in an options list. 


1 .) INCLUDE <SYSLIB> (HALSTART) 

<SYSLIB> is the name of auto-call library and 
defaults to SYSLIB. 

This card may be suppressed. See option list 
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description to follow. 

2) HALMAP CSECT 


The content is detailed in a later paragraph. 
This object deck may be suppressed. See the 
options list. 

3) Stack object decks for each PROGRAM and TASK. 

4) INCLUDE <TEMPLOAD> ( <MEMBER>) 

<TEMPLOAD> defaults to TEMPLOAD. 

<MEMBER> defaults to TEMPNAME. 

5) ENTRY HALSTART 

6) NAME <MEMBER>( R) 

Produced only if <MEMBER> was not TEMPNAME. 
HALLINK Option 

Parameters may be passed to HALLINK, The JCL for this 
is PARM.LKED s 'link parms/HALLINK parms'. 

The slash is optional if no HALLINK parameters are 
passed. 

HALLINK parameters are coded as numbers* 0-9. 


Code Significance 

0 Suppress printing of call tree 

and recursion diagnostics, 

1 Suppress INCLUDE <SYSLIB> 

(HALSTART) 

2 Suppress HALMAP CSECT. If a 

HALMAP CSECT exists in the input 
load module, i.e. a module 
created by HALLINK is reprocessed, 
this option is Ignored. 

3 Recursion ignored. Recursive 

PROGRAMS and TASKS receive 
stack size of 32760(plus 
interrupt time). 

4 Pass Link Editor parameters 

to second Link Editor only. 
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Attempt to open DCB with 
DDNAME LINKLIB. If sue 
cessful, the Link Editor and 
HALLKED will be retrieved 
from this library or 
system library. STEPLIB 
will not be used. 

6-9 Reserved. 


HALMAP CSECT 

The HALMAP CSECT contains the following information about 
the load module: 

1) Number of Process Control Blocks (PCBs) required 
by the Realtime Executive to handle all potential 
processes in the module. 

2) ‘Address of each PROGRAM, COMSUB, and COMPOOL, and 

an indicator as to which type each pointer is 
referencing. 

3) Simulation Data File (SDF) file member name containing 
information about symbols in corresponding compilation 
units. 


Layout of HALMAP 


Loc Length 

0 2 

2 2 

n 


Pointer Table 


Description 

# of entries in pointer table 

# of PCBs 

Pointer table. 12 byte 
entries as outlined below. 


1 Type (X'OO'sCOMPOOL, 

X'OI'sPROGRAM, 
X'03'=C0MSUB) 

3 address of CSECT 

6 SDF member name 


Note that the last entry is not indicated 
being set in type field. Use halfword at 


by high order bit 
location 0 in HALMAP 
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to determine number of entries 


HALLINK Return Codes 


Return Codes 

0,4,8,12,16 

1,5,9,13,17 


100 

104 


108 


124 


128 


As defined by Link Editor. 

Return code of n corresponds 
to Link Editor return code of (n-1) 
and recursive calls detected in 
load module and HALLINK option 3 
was specified. 

Recursive calls and option 3 
not specified. 

Insufficient space for tables. 

Rerun in larger partition. 

Current implementation requests 
32K, 1 6K , 8K, and 4k, 
in that order, stopping 
when a request is satisfied. 

Usable to open STACKOBJ 
or TEMPLOAD , If SYSPRINT 
cannot be opened, HALLINK 
option 0 assumed. 

User specified a member name 
on TEMPLOAD card. TEMPLOAD 
must, not have a member 
name specified. 

I/O error reading 
TEMPLOAD directory. 
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Appendix J 


Block Location and Search Algorithms for Type XI and III 


The location of a block in a Type II or III is determined by 
the following algorithm: 

1) A starting location for the search is determined by the 
formula B MOD DCBREL » where B is the block number and DC3REL is 
the number of blocks in a Type II file with OPTCD=R or the number 
of tracks in a Type II or Type III without OPTCD=R (the default). 
For example# if B=10 and a Type III file has 7 tracks# then the 
starting location is 10 MOD 7# or 3* This number is interpreted 
as the relative block or track in the file# again depending on 
OPTCD • In this case the starting location is relative track 3 of 
a seven track file# or the fourth track (the first track is 
relative track 0). 

2) I f , OPTCD=E is specified# the search starts at the beginning of 
' the track determined above and continues for as many tracks (or 

blocks) as the number specified in the LIMCT parameter* The 
search is for available space for a new block or for an existing 
block. If QPTCD=E is not specified, the search stops at the end 
of the track as determined in 1)* If OPTCD=E is specified but 
LIMCT is not# then LIMCT defaults to the maximum# causing the 
entire file to be searched. (If the end of the file is reached# 
the search continues from the beginning of the. file* ) 

3) If the search fails# the result is either ERROR 64 - NO SPACE 
IN FILE# or ERROR 70-79 - BLOCK bbbbbbbbbb NOT FOUND# depending 
on whether an output or an input file statement was being 
executed. 

Conclusions: 

1) If the range of B is uniformly sparse (say B=100# 200# etc) 
then the uniform increment (in this case 100) should be prime 
with respect to DCBREL- 

2) Available space in an existing file may be increased without 
increasing the size of the file by utilizing 0PTCD=E and/or an 
increased LIMCT. 
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